Skip to content
Vocapable Developers

Business-pathway counters: leads, messages, tickets, callbacks, appointments

GET
/v1/analytics/pathways
curl --request GET \
  --url https://api.vocapable.com/v1/analytics/pathways \
  --header 'Authorization: Bearer <token>'

What the receptionist’s conversations actually left behind (ADR-0037).

Counts durable rows only - never the outbox, which is a delivery artifact - so the report and the resources it summarizes can never disagree.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
start
Any of:
string format: date-time

Inclusive lower bound, ISO-8601. The attempt and turn ledgers are month-partitioned, so a report must name both sides of its window and may span at most 93 days.

end
Any of:
string format: date-time

Exclusive upper bound, ISO-8601.

group_by
Any of:
Array<string>
Allowed values: agent_version day

Repeatable: agent_version and/or day. Omit for one total.

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
PathwaysReport
object
window
required
ReportWindow

The half-open window the report was actually computed over.

object
start
required
Start
string format: date-time
end
required
End
string format: date-time
group_by
Group By
Array<string>
Allowed values: agent_version day
buckets
Buckets
Array<object>
PathwaysBucketOut

One group of the business-pathway counters (ADR-0037).

leads_captured is null - never zero - under an agent_version slice: the durable source (contacts.lead_captured_at) carries no version attribution, and a zero would put a false data point on a chart.

object
agent_version_id
Any of:
string
day
Any of:
string format: date
leads_captured
Any of:
integer
messages_taken
required
Messages Taken
integer
tickets_opened
required
Tickets Opened
integer
tickets_resolved
required
Tickets Resolved
integer
callbacks_scheduled
required
Callbacks Scheduled
integer
appointments_created
required
Appointments Created
integer
Example
{
  "group_by": [
    "agent_version"
  ]
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}