← All endpoints / AI Narrative Layer

AI Chat Runtime

POST/api/v1/ai/chats/{chat_id}
POSThttps://vedintelastroapi.com/api/v1/ai/chats/{chat_id}

Send a message to a configured AI Chat assistant. Streams SSE tokens (data: {"token":"…"} events, then one audit event, then data: [DONE]). api_key goes in the JSON body, not the URL. chat_id must be owned by the same user as the api_key. Requires Developer+ plan.

Requires a paid plan (Developer or above).

Parameters

NameInRequiredTypeDescription
chat_idpathYesstringchat_id from your dashboard

Request Body (application/json)

FieldRequiredTypeDescription
api_keyYesstringVedIntel API key (in JSON body, not query string)
profileNostringOptional birth data {dob, tob, lat, lon, tz}, applied to every turn. A JSON-encoded string of the object is also accepted.
messagesYesstringConversation history, oldest first: [{role: "user"|"assistant", content}]. A JSON-encoded string of that array, or plain text (one user turn), is also accepted.

Example Request

curl -X POST "https://vedintelastroapi.com/api/v1/ai/chats/YOUR_CHAT_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_API_KEY",
  "profile": "VALUE",
  "messages": "VALUE"
}'
← Back to all endpointsInteractive Docs
Get a free API key →