Skip to main content
PATCH
Update an Agent's deterministic human handoff policy

Authorizations

Authorization
string
header
required

A Contact Button scoped bearer key. Send Authorization: Bearer <token>. Token abilities are enforced independently of workspace membership; both checks must pass. Interactive MCP clients use registered OAuth applications, Authorization Code + PKCE, audience-bound tokens, and explicit workspace grants. Personal Sanctum tokens remain supported.

Headers

Idempotency-Key
string

Stable 8–120 character key for safe mutation retries.

Required string length: 8 - 120

Path Parameters

workspace
string<uuid>
required
agent
string<uuid>
required

Body

application/json
enabled
boolean
trigger_order
enum<string>[]
Required array length: 6 elements
Available options:
explicit_request,
unsupported_answer,
keywords,
negative_feedback,
inactivity,
custom
triggers
object
human_profile
object
contact_app_ids
string<uuid>[]
Maximum array length: 10

Response

Successful data envelope.

data
any
required
meta
object
required