API ReferenceAI Agents

Execute-Async Ai Agents Events

Execute an AI agent input event asynchronously.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
agentstringRequiredformat: "id"
The ID of the AI agent that will consume the event.
eventobjectRequired
An event to be processed by an AI agent.
session_objectstringRequiredformat: "text"
An identifier of a session with an AI agent.
client_metadataobjectOptional
The metadata to be sent to the client with the notifications of execution progress.
contextobjectOptional
Additional metadata to be used by the AI agent for the event.
event_source_targetobjectOptional
The source of the event to send notifications to, of asynchronous execution progress.
targetenumOptional
Allowed values:
webhook_targetobjectOptional
The source of the event to send notifications to, of asynchronous execution progress.

Response

Response object to provide final response after asynchronous execution of input event to AI agent.
sessionobject

Errors