Skip to main content
PATCH
Update Post-call Settings

Authorizations

Authorization
string
header
required

Your API key (ta_live_…) from Settings → API keys, sent as Authorization: Bearer <key>. Keep it on a server: it can message every customer you have. A key is full, build or read-only; a request its level does not allow is refused with 403.

Headers

Thinnest-Workspace
string

Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace.

Example:

"org_3fKq9TzQ1mN8vB2xR7cLpA"

Path Parameters

id
string
required

The agent's ag_… id.

Example:

"ag_5c4a5f93-2b1e-4d7a-9f60-8e2d1c3b4a71"

Body

application/json

The post-call settings to change. At least one; nothing else is accepted.

summariseCalls
boolean

Write a short summary after each call.

recordCalls
boolean

Record each call.

collectFields
object[] | null

The details to fill from every call, replacing the list. An empty list (or null) stops collecting.

Maximum array length: 30

Response

The agent's post-call settings, after the change.

agent
string
required

The agent's ag_… id.

takesCalls
boolean
required

False when the agent takes no calls — the two switches then do nothing.

summariseCalls
boolean
required

Writes a short summary after each call.

recordCalls
boolean
required

Records each call.

recordingKeptDays
integer
required

How long your plan keeps a recording before deleting it.

collectFields
object[]
required

The details filled from every call.

collectMode
enum<string> | null
required

Read only. parser reads the transcript after the call; tool has the agent save the details as it goes. Null when nothing is collected. Chosen in the console on the agent's Actions page.

Available options:
parser,
tool,
null