Auth: required. Send an ivy_ API key (Authorization: Bearer ivy_… or X-Ivy-Api-Key), a Clerk session JWT (Authorization: Bearer …) or the Clerk __session cookie (browser sessions). See Authentication.

Approve or reject a pending interrupt. The executing session must still be live (i.e., the /execute SSE stream is still open on the same warm serverless container). Resolving an interrupt for a completed or timed-out session returns 404 RUNTIME_NOT_FOUND.

When modifiedArguments is provided the agent rewrites the tool call arguments via NL diff (Gemini Flash) before execution — falls back to original args on LLM failure.

Request

Path parameters

sessionIdstring (uuid)

Session UUID (UUIDv7 — time-ordered)

interruptIdstring

Interrupt ID from the interrupt.requested SSE event payload

Request body

approvedboolean

Allow (true) or deny (false) the tool call

notestring

Optional human note attached to the decision, stored in the event log

modifiedArgumentsobject

Override tool arguments — agent performs NL-based diff rewrite before execution (falls back to original on LLM failure)

Responses

`200` OK

Interrupt resolved

Response shape:

okboolean

interruptIdstring

decisionenum ("approved" | "rejected")

curl -X POST 'https://ivybiosciences.com/api/harness/sessions/{sessionId}/interrupt/{interruptId}/resolve' \
  -H "Authorization: Bearer $IVY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "approved": false
}'

POST /harness/sessions/{sessionId}/interrupt/{interruptId}/resolve

Request

Path parameters

Request body

Responses

`200` OK

`400` Bad Request

`401` Unauthorized

`403` Forbidden

`404` Not Found