Skip to main content
POST /{org}/{agent}/v1/responses Speaks the OpenAI Responses API shape. Auth: a session token or a kt_live_... key.

Request

input
string | array
required
The user input - a string, or an array of input items.
stream
boolean
default:"false"
true -> SSE; false -> a single response object.
previous_response_id
string
Continue from a prior response - the Responses-style way to keep context across turns. Maps to the underlying Karta session.
store
boolean
Whether to pin/persist the session.
model
string
Accepted for OpenAI-client compatibility but has no effect: it does not select the model. The model is configured per agent and org on the platform.

Unary response

output is an array of message items; output_text is the text output flattened for convenience. Pass the returned id as previous_response_id on the next call to continue the conversation - a response echoes previous_response_id only when the request supplied one.

Streaming

A failure mid-stream arrives as response.failed.

Status codes

200 (unary or stream), 401, 402 (budget or instance cap), 403 (identity_mismatch), 404 (unknown agent / cross-tenant / no active release), 409 (release not materialized), 422 (BYOK rejected). See Errors.