Execute a published Managed Agent
Runs one JSON turn against the published production snapshot. Omit sessionId on the first turn and pass the returned sessionId on subsequent turns. Reuse the same Idempotency-Key only when retrying the exact same logical turn. For a 429 response, retry that key only when retryable is true and Retry-After is present.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
managed-agents. writeOAuthPrivate IntegrationSub-Account TokenRequest​
Headers
API version.
v3v3Unique key for this logical turn. Maximum 128 characters.
Possible values: non-empty and <= 128 characters
turn-7f3cf4c0-39eb-46be-baa3-a1eb15021f25Path Parameters
Managed Agent ID.
027ee957-ae94-40ad-89a3-b25c985f729bBody
Authorized sub-account ID.
Possible values: non-empty and <= 256 characters
ve9EPM428h8vShlRW1KTUser message for this turn.
Possible values: non-empty and <= 10000 characters, Value must match regular expression \S
Summarize today's new contacts.Session ID returned by a previous turn.
Possible values: non-empty and <= 256 characters
a1b2c3d4-e5f6-7890-abcd-ef1234567890Optional contact to hydrate into runtime context.
Possible values: non-empty and <= 256 characters
cid_abc123def456Optional JSON variables. Maximum encoded size is 32 KiB and maximum nesting depth is 5. Runtime identity names are reserved and rejected with 400: the roots account, contact and location, and the keys agentId, agencyId, companyId, contactId, executionId, locationId, sessionId and userId. Matching is case-insensitive and applies at the top level and under the optional global, inputs, raw and runtime prefixes, in either dotted (runtime.contact.id) or nested form. Use the endpoint locationId and the top-level contactId instead. These names nested under one of your own keys (for example customer.contactId) are accepted.
Response
Managed Agent turn completed.
Whether the turn completed successfully.
truetrueManaged Agent that handled the turn.
027ee957-ae94-40ad-89a3-b25c985f729bPass this value on the next turn to continue the conversation.
a1b2c3d4-e5f6-7890-abcd-ef1234567890Final text returned by the Managed Agent.
Here are today's new contacts…Tool identifiers invoked during the turn.
["web_search"]Media assets generated during the turn.