Skip to main content
POST
/
messages
/
pending
List pending messages (Approval Queue)
curl --request POST \
  --url https://api.svantic.com/messages/pending \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "<string>",
  "limit": 50,
  "offset": 0
}
'
{
  "messages": [
    {
      "message_id": "<string>",
      "session_id": "<string>",
      "tenant_id": "<string>",
      "state": "input-required",
      "user_input": "<string>",
      "assistant_output": "<string>",
      "task_data": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123
}

Body

application/json

Request to list messages awaiting human input. The tenant is derived from the caller's JWT — there is no tenant_id field in the request body.

​
session_id
string

Optional filter — only show pending messages for this session.

​
limit
integer
default:50

Maximum number of results.

​
offset
integer
default:0

Pagination offset.

Response

List of pending messages.

List of messages in input-required state.

​
messages
object[]
required
​
total
integer
required

Total number of pending messages (for pagination).