Skip to main content
POST
Use this endpoint for text-only compatibility clients. The body is typically {"prompt":"Hello"}; supply the user and session in the user_id and session_id headers, rather than body fields Provide both headers explicitly to avoid grouping unrelated calls under default user or session identifiers. The service checks and creates the session, using the loaded agent application name
Invocation saves the session and executes models and tools, which can incur charges or perform external actions. Resending the same message can repeat these actions
The response is SSE. Read continuously with curl -N and handle in-stream error messages. For structured ADK messages, use Run Harness with SSE

Authorizations

Authorization
string
header
required

Optional locally without a gateway; cloud deployments use the Runtime API key or user-pool JWT required by that deployment, never the model API key

Headers

user_id
string
default:agentkit_user
session_id
string
default:""

Body

prompt
string

User message for this invocation

harness
object

Response

SSE event stream

The response is of type string.

Last modified on September 19, 2026