Skip to main content
POST
Ask a natural-language question

Authorizations

Authorization
string
header
required

An API key (shumi_sk_…) or a session JWT. Create a key with shumi login and shumi keys create.

Body

application/json
messages
object[]
required

Conversation history. The last message must have role user.

walletAddress
string

Optional EVM address, used for entitlement resolution.

deviceId
string

Anonymous device identifier. Grants exactly one free query.

raw
boolean

Return the unformatted engine payload.

archetype
string

Optional persona applied to the answer.

commandContext
object

Prior CLI command context, folded into the prompt.

Response

Streamed answer.

The response is of type string.