Inject User Message
const url = 'https://api.ultimateteam.ai/api/v1/team-chat/threads/example/intervene';const options = { method: 'POST', headers: {'X-API-Key': '<X-API-Key>', 'Content-Type': 'application/json'}, body: '{"content":"example","metadata":{},"override_action":"example","redirect_to_roles":["example"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.ultimateteam.ai/api/v1/team-chat/threads/example/intervene \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <X-API-Key>' \ --data '{ "content": "example", "metadata": {}, "override_action": "example", "redirect_to_roles": [ "example" ] }'Inject a user message or override into an agent thread.
Args: thread_id: The thread UUID string. body: User intervention data. user: The authenticated user context. svc: The intervention service (injected).
Returns: The user override message.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Input schema for user intervention in agent conversations.
Attributes: content: The user’s message content. override_action: Optional action — “cancel” or “redirect”. redirect_to_roles: Roles to redirect conversation to. metadata: Optional extensible metadata.
object
Examplegenerated
{ "content": "example", "metadata": {}, "override_action": "example", "redirect_to_roles": [ "example" ]}Responses
Section titled “ Responses ”Successful Response
Response schema for a persisted conversation message.
Attributes: id: Unique message identifier. thread_id: Owning thread identifier. sender_role: Agent role or “user”. sender_id: User ID if sender is human. content: Message content text. message_type: Type of message. artifacts: List of artifact IDs referenced. a2a_task_id: Link to A2A task if applicable. metadata: Extensible metadata. created_at: When the message was created.
object
Examplegenerated
{ "a2a_task_id": "example", "artifacts": [ "example" ], "content": "example", "created_at": "2026-04-15T12:00:00Z", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "message_type": "example", "metadata": {}, "sender_id": "example", "sender_role": "example", "thread_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Validation Error
object
object
object
Examplegenerated
{ "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ]}