Rensei docs
API ReferenceSessions ( Public)

Send a prompt to a running session

Resolves a canonical session id or its public/tracker alias to one tenant-scoped session. Non-terminal input is durably queued on the session heartbeat rail; terminal retries use a durable admission receipt before reset/re-dispatch. A terminal generation is re-dispatched only when its original work type and provider-session resume identity are established from live or durable evidence; missing continuity returns a typed held 409 and creates no queue item. A caller-supplied idempotency key returns the exact current queued/in_flight/applied/dead_lettered active disposition or the original terminal receipt and conflicts on changed input. `in_flight` means claimed by the daemon but not acknowledged as applied; `delivered:true`/`deliveryTier:live` appears only after an exact applied ACK.

POST
/api/public/sessions/{id}/prompt

Authorization

headerAuthorizationBearer <rsk_live_*>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

Path Parameters

id*string

Canonical session id, 16-character public hash, or tracker-session alias.

Header Parameters

Idempotency-Key?string

Caller-stable prompt admission key. Equivalent to request-body idempotencyKey; if both are present they must match.

Match^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
Length8 <= length <= 128

Request Body

application/json
  1. body
prompt*string
idempotencyKey?string
Match^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
Length8 <= length <= 128

Response Body

Current durable disposition. in_flight is daemon-claimed but not yet acknowledged as applied by the harness.

application/json
  1. response
delivered*boolean
deliveryTier*string
Value in"durable""live"
disposition*string
Value in"queued""in_flight""held""applied""dead_lettered"
idempotencyKey*string
promptId*string
sessionId*string
status*string
Value in"queued""in_flight""held""applied""dead_lettered"
sessionStatus*string
Value in"queued""in_flight""held""applied""dead_lettered"
Example Request
curl -X POST 'https://app.rensei.ai/api/public/sessions/string/prompt' \  -H 'Content-Type: application/json' \  -d '{  "prompt": "string"}'
Example Response
{  "delivered": true,  "deliveryTier": "durable",  "disposition": "queued",  "idempotencyKey": "string",  "promptId": "string",  "sessionId": "string",  "status": "queued",  "sessionStatus": "queued"}