POST /{org}/{agent}/v1/responses
Speaks the OpenAI Responses API shape. Auth: a
session token or a kt_live_... key.
Request
The user input - a string, or an array of input items.
true -> SSE; false -> a single response object.Continue from a prior response - the Responses-style way to keep context
across turns. Maps to the underlying Karta session.
Whether to pin/persist the session.
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
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.
