Chat

Chat Query

Ask a natural-language question about the tenant's indexed documents.

Returns a grounded answer with documentId citations; confident=false means the underlying data could not support a reliable answer. Send back the returned sessionId to continue the conversation; omit it to start a new one.

post/api/v1/chat/query

Request

  • Base URL: https://api.gemina.co (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemina.co/api/v1/chat/query
  • Auth: one of:
    • API key in header X-API-Key
    • OAuth 2 (password, token URL token)

Request body

messagestring required
sessionIdstring uuid nullable

Continue an existing conversation. Omit to start a new one; the response returns the sessionId to send on follow-up turns.

endUserIdstring nullable

Server-to-server (API key) path only: trusted within-tenant filter. On the token path the token's signed scope always wins.

Response

Successful Response

servedAtstring date-time
servedAtTimestampnumber
createdAtstring date-time nullable
createdAtTimestampnumber nullable
answerstring required
sessionIdstring uuid required

Conversation id — send back to continue this chat

citationsstring[]

documentId values the answer relies on

intentstring nullable

structured | semantic | hybrid | aggregation

confidentboolean

False when the data could not support a reliable answer

Changes

No recorded changes to this operation across all 1 revision of this API.