v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB
Super Agent

Send Super Agent Message

Sends a message to the super agent. If session_id is not provided, creates a new session. Returns synchronously if completed within 15 seconds, otherwise returns 202 Accepted with session ID for polling. Optionally accepts a callback_url for webhook notification when the assistant response is ready.

post/super-agent/messages

Query parameters

callback_urlstring uri

Optional webhook URL to receive the assistant's response when processing completes

Request body

session_idstring

Optional session ID. If not provided, a new session will be created.

contentstring required

The message content to send to the super agent

timezonestring

Optional user timezone for timestamp formatting (e.g., 'America/New_York')

Example request

{
  "session_id": "session-uuid-456",
  "content": "What were our Q1 revenue results?",
  "timezone": "America/New_York"
}

Response

Message processed successfully with assistant response

session_idstring

The session ID

Example response

{
  "session_id": "session-uuid-456",
  "user_message": {
    "id": "msg-uuid-1",
    "session_id": "session-uuid-456",
    "content": "What were our Q1 revenue results?",
    "role": "user",
    "timestamp": "2024-03-18T14:30:00Z",
    "metadata": {}
  },
  "assistant_message": {
    "id": "msg-uuid-2",
    "session_id": "session-uuid-456",
    "content": "Based on the Q1 data, revenue targets were met at 105%.",
    "role": "assistant",
    "timestamp": "2024-03-18T14:30:05Z",
    "metadata": {}
  }
}