---
title: "Send Super Agent Message"
method: POST
path: "/super-agent/messages"
tags: ["Super Agent"]
---

# Send Super Agent Message

`POST /super-agent/messages`

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.

## Query parameters

- `callback_url` string, uri

## Request body

- SendSuperAgentMessageRequest
  - `session_id` string — Optional session ID. If not provided, a new session will be created.
  - `content` string, required — The message content to send to the super agent
  - `timezone` string — Optional user timezone for timestamp formatting (e.g., 'America/New_York')

## Response `200`

Message processed successfully with assistant response

- SuperAgentMessageResponse
  - `session_id` string — The session ID
  - `user_message` SuperAgentMessage
    - `id` string — Unique identifier of the message
    - `session_id` string — ID of the session this message belongs to
    - `content` string — The message content
    - `role` 'user' | 'assistant' — The role of the message sender
    - `timestamp` string, date-time — When the message was created
    - `metadata` object — Additional metadata associated with the message
  - `assistant_message` SuperAgentMessage
    - `id` string — Unique identifier of the message
    - `session_id` string — ID of the session this message belongs to
    - `content` string — The message content
    - `role` 'user' | 'assistant' — The role of the message sender
    - `timestamp` string, date-time — When the message was created
    - `metadata` object — Additional metadata associated with the message

## Other responses

- `202` — Message accepted, processing in background
- `400` — Invalid request parameters
- `401` — Valid user-level API key required
- `403` — Session does not belong to user's organization
- `default` — Unexpected error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)