DEdexto
Agents

Send a message

Send the end user's message and start a run. Stream its progress from the session's events.

post/v1/agents/{agent_id}/sessions/{session_id}/messages

Request

  • Base URL
    https://api.dexto.ai
  • URL
    https://api.dexto.ai/v1/agents/{agent_id}/sessions/{session_id}/messages
  • Auth
    HTTP bearer

Path parameters

agent_idstring required
session_idstring required

Headers

Idempotency-Keystring

Request body

contentstring required

The end user's message.

Response

Accepted.

stop_reason'completed' | 'cancelled' | 'spend_limit_reached' | 'insufficient_credits' | 'max_steps' | 'error' nullable required

Why the run stopped, beside its status: completed, cancelled, a reached spend limit, no credits left, the step limit, or any other failure (error).

created_atstring date-time required
idstring uuid required
object'agent_run' required
session_idstring uuid required
status'queued' | 'running' | 'waiting_approval' | 'completed' | 'failed' | 'cancelled' required

Changes

No recorded changes to this operation across all 1 revision of this API.