Skip to main content
POST
Send input to a session

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Path Parameters

session_id
string
required

Session ID

Body

application/json
type
string
required

user.message (requires text), user.interrupt, or user.approval (requires approval_id and decision; only while the session is awaiting_approval).

text
string | null
approval_id
string | null

user.approval: the approval_id of the pending agent.approval_request.

decision
string | null

user.approval: allow or deny.

message
string | null

user.approval: optional note, at most 4 KiB. On deny the agent reads it as the reason and continues its turn without the tool call.

Response

The appended event's seq and the session status

object
string
required
session_id
string
required
seq
integer<int64>
required
status
string
required