Agent

Submit Hitl Decision

patch

Submit a Human-in-the-Loop (HITL) decision for an agent approval request.

Authorizations

OAuth2PasswordBearerAPIKeyHeader

OAuth2passwordRequired

Token URL:

cookie

__Secure-next-auth.session-tokenany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request model for submitting Human-in-the-Loop (HITL) decisions.

Attributes: request_id (str): The UUID observed in the stream. decision (str): The decision made by the user - one of "approved", "rejected", or "skipped". operator_input (str | None): Free-form comment for audit/UIs. Defaults to empty string if omitted. run_id (str | None): Pass through if you track session identifiers on the client side.

request_idstringRequired

The UUID observed in the stream

decisionstring · enumRequired

The decision made by the user - one of 'approved', 'rejected', or 'skipped'

Possible values:

operator_inputstringOptional

Free-form comment for audit/UIs. Defaults to empty string if omitted.

Default: ""

run_idany ofOptional

Pass through if you track session identifiers on the client side.

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

400

Bad Request - Invalid input parameters

application/json

422

Validation Error

application/json

500

Internal Server Error

application/json

patch

/agents/hitl/decision

HTTPcURLJavaScriptPython

PATCH /agents/hitl/decision HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "request_id": "text",
  "decision": "approved",
  "operator_input": "",
  "run_id": "text"
}

{
  "status": "ok",
  "message": "Request bc4d0a77-7800-470e-a91c-7fd663a66b4d approved"
}