Send a message - Decimal

POST

chat

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?"
}
'

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

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

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

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

Get conversationReturns the conversation with all messages. Use this to poll for completion after sending a message — check the top-level `status` field.

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?"
}
'

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

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true
  }
}