Graine AI

Call progress

Sent as a call moves through ringing, answered and so on, only for the event types your subscription names.

Sent as a call moves through ringing, answered and so on, only for the event types your subscription names. Carries the envelope only.

Rate limit: none — this is an event Graine delivers to you, not a request you make. A busy agent fleet can emit these in bursts; answer 2xx within 30 seconds and dedupe on event_id.

POST
/call_progress

Authorization

Authorization
Required
Bearer <token>

Your Graine API key. Create one in the dashboard under Developers, or via POST /v2/api-keys. Send it as Authorization: Bearer <key>.

In: header

Request Body

application/jsonRequired

event_type
Required
string | null

Which event this is. Branch on this.

event_id
Required
string | null

Unique per delivery. Use it to make your handler idempotent.

versionstring | null

Payload version.

timestampstring | null

When the event was emitted, ISO-8601 UTC.

call_id
Required
string | null

The execution_id you received when the call was placed.

call_sidstring | null

The carrier's own leg id. For support tickets only.

agent_idstring | null

The agent that conducted the call.

agent_namestring | null

That agent's name at the time of the call.

organization_idstring | null

Your organization.

workspace_idstring | null

Same value as organization_id.

statusstring | null

The call's outcome — completed, failed, busy, no-answer…

sub_statusstring | null

A finer reason for the status, when there is one.

call_typestring | null

inbound or outbound.

calling_sourcestring | null

What placed the call — api, campaign, retry, follow-up.

custom_args_valuesobject | null

The variables you sent with the call.

to_numberstring | null

The number dialled, E.164.

from_numberstring | null

The caller ID used, E.164.

bulk_list_idstring | null

The batch this call belonged to, if any.

called_onstring | null

When the call was placed, in the campaign's timezone.

created_atstring | null

When the record was created, ISO-8601 UTC.

Response Body