Skip to main content
Send a message to the assistant
curl --request POST \
  --url https://sapi.withsutro.com/projects/{projectId}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-sutro-api-client: <api-key>' \
  --data '
{
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ]
}
'
{
  "messageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "queued"
}

Authorizations

​
Authorization
string
header
required

Builder authentication and authorization

​
x-sutro-api-client
string
header
required

A unique identifier for the API Client making a request

Path Parameters

​
projectId
string<uuid>
required

Body

application/json

The user message to send

​
content
object[]
required

Array of message parts containing the user's message

Response

Message accepted and queued for processing

​
messageId
string<uuid>
required

ID of the created message

​
jobId
string<uuid>
required

ID of the background job processing the message

​
status
enum<string>
required

Current status of the job

Available options:
queued