Sessions

Send session input

Send exactly one event: agent.session.input.message or agent.session.input.cancel. The SandBase extension form {input, file_ids} sends text with ready attachments and cannot be combined with events. Idempotency-Key is optional but recommended; reuse the same key when retrying the same input.

post/v1/agents/sessions/{session_id}/events

Request

  • Base URL: https://api.sandbase.ai
  • URL: https://api.sandbase.ai/v1/agents/sessions/{session_id}/events
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

Idempotency-Keystring

Optional. Send a stable key so retries do not create duplicates.

OpenAI-Beta'agents=v1'

Optional OpenAI SDK header. When present it must be agents=v1.

Request body

inputstring

SandBase extension. Text input, non-empty.

file_idsstring[]

SandBase extension. Up to 10 distinct ready attachments.

Response

Input accepted. The response has no body.

Changes

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