Interact with an agent
POST/v2/agents/:agent_key/sessions/:session_key/events
Creates a new input event in the session to interact with the agent.
Request
Responses
- 201
- 400
- 403
- 404
- 409
- 422
- 429
- 502
The input event is created.
The request to create an input event is malformed.
Permissions do not allow creating input events in this session.
Agent or session not found.
The session is already running. Use the since field in the request body to queue input.
The agent configuration is invalid (for example, invalid instruction or tool description templates).
An LLM quota configured on the agent or its LLM is exhausted. The body names the quota and the response carries a Retry-After header. Returned when the request is not streamed; a streamed request receives the refusal as an error event in the stream on a 200.
Response Headers
Seconds until the exhausted quota window turns and the call may be retried.
Communication with the session failed.