Chat (v1)

Create or continue a v1 conversation.

POST /api/v1/conversations

cURL

curl --request POST \
  --url 'http://localhost:8000/api/v1/conversations' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "message": "Two-person tent, green — replacement for damaged pole set.",
  "messages": [
    {
      "role": "system",
      "content": "Two-person tent, green — replacement for damaged pole set."
    }
  ],
  "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "model": "string",
  "temperature": 1.5,
  "max_tokens": 1
}'

200

{
  "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "response": "string",
  "tokens_used": 1,
  "processing_time_ms": 250
}

Create or continue a v1 conversation.

Request body

ConversationRequestV1

message · string,null

messages · MessageV1[],null

conversation_id · string,null

model · string,null

temperature · number,null

max_tokens · integer,null

Response

ConversationResponseV1

conversation_id · string · required

response · string · required

tokens_used · integer · required

processing_time_ms · integer · required

Status codes

Code	Meaning
200	Successful Response
401	Authentication required
422	Validation Error
429	Rate limit exceeded

cURL

curl --request POST \
  --url 'http://localhost:8000/api/v1/conversations' \
  --header "Authorization: Bearer $STATESET_AGENTS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "message": "Two-person tent, green — replacement for damaged pole set.",
  "messages": [
    {
      "role": "system",
      "content": "Two-person tent, green — replacement for damaged pole set."
    }
  ],
  "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "model": "string",
  "temperature": 1.5,
  "max_tokens": 1
}'

200

{
  "conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "response": "string",
  "tokens_used": 1,
  "processing_time_ms": 250
}