POST /api/chat

Send a message to Truvisory's AI agent and receive a single reply. Reuse the same sessionId across turns to preserve conversation context.

Quick reference

Method	`POST`
URL	`https://truvisory.com/api/chat`
Request	`application/json`
Response	`application/json`
OpenAPI	chat.json

Request body

Field	Required	Type	Description
`sessionId`	yes	UUID v4	Client-generated session id. Reuse across turns for context.
`message`	yes	string	1–2000 characters of user input.

{
  "sessionId": "8b5f3c2e-1a4d-4f0a-9c2b-7d8e6a1b2c3d",
  "message": "Are you SDVOSB-verified?"
}

Response (200)

{
  "reply": "Yes — Truvisory is SBA-verified SDVOSB and primary NAICS 541512..."
}

Errors

Status	Body	Cause
400	`{ "error": "bad_request" }`	Malformed body, missing fields, or message length out of range.
429	`{ "error": "rate_limited" }`	Too many requests for this session or IP.
500 / 502	`{ "error": "agent_unavailable" }`	Upstream agent unreachable; retry with backoff.

Example

curl -X POST https://truvisory.com/api/chat \
  -H 'content-type: application/json' \
  -d '{"sessionId":"8b5f3c2e-1a4d-4f0a-9c2b-7d8e6a1b2c3d","message":"What is the Ship-It Sprint?"}'