Send a message

Send a message to get an AI-powered response. Omit conversation_id to start a new conversation, or provide one to continue an existing conversation.

Returns 202 Accepted immediately. The AI processes in the background. Poll GET /v0/chat/{conversation_id} until status is completed.

POST /v0/chat

cURL

newConversation

curl --request POST \
  --url https://api.getdecimal.ai/v0/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "How do I configure SSO?"
}
'

202

{
  "conversation_id": "<string>",
  "status": "processing"
}

Authorizations

Authorization · string · header · required

API token with sk-de- prefix. Created in the Decimal dashboard under Settings → API Tokens.

Body

application/json

message · string · required

The user's message.

Required string length: 1 - 16000

conversation_id · string

Omit to start a new conversation. Provide to continue an existing conversation.

Response

202

application/json

Message accepted for processing.

conversation_id · string · required

Conversation ID. Use this to poll or continue the conversation.

status · enum<string> · required

Available options: processing