Skip to main content
POST
Ask a question about an event

Authorizations

x-access-token
string
header
required

Organization API token. Generate from Organization Settings → API Tokens.

Path Parameters

eventId
integer
required

The event to ask about.

Body

application/json
question
string
required

The question, in plain language. Whitespace is collapsed before the length check: under 2 or over 500 characters returns 422 (empty / too_long), and a value over 1000 characters is rejected with 400.

Required string length: 2 - 500
conversation_id
string<uuid>

The conversation_id from a previous answer, to ask a follow-up in the same thread.

lang
string

Answer language as a language tag, e.g. en, fr, pt-BR.

Maximum string length: 16
Pattern: ^[A-Za-z]{2,3}([-_][A-Za-z0-9]{2,8})?$

Response

The answer and its sources.

status
enum<string>
required
Available options:
ok
answer
string
required

The answer as Markdown. [n] marks citation n.

citations
object[]
required
actions
any[]
required

Always empty — this endpoint is read-only.

conversation_id
string<uuid>
required

Send this back with a follow-up question to continue the conversation.

message_id
string<uuid>
required

The id of this answer.