Approve or decline a suspended tool call

curl --request POST \
  --url https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "<string>",
  "metadata": {},
  "run_id": "<string>",
  "tool_call_id": "<string>"
}
'

{
  "success": true,
  "error": "<string>",
  "stream_id": "<string>"
}

Tasks

Approve or decline a suspended tool call

Submits an approval decision for a task whose agent stream is suspended waiting for user input (e.g., plan approval, ask_question).

approve: resumes the agent with the provided metadata/answers.
decline: cancels the pending action.

For suspended streams, the endpoint atomically transitions the stream from suspended to resuming (CAS guard) to prevent double-approve. For active streams with in-tool timeout approval (ask_question), the endpoint forwards the decision to the Bun agent’s in-memory waiter.

POST

api

tasks

{id}

approve

Approve or decline a suspended tool call

curl --request POST \
  --url https://neo.api.projectdiscovery.io/api/v1/tasks/{id}/approve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "<string>",
  "metadata": {},
  "run_id": "<string>",
  "tool_call_id": "<string>"
}
'

{
  "success": true,
  "error": "<string>",
  "stream_id": "<string>"
}

Authorizations

Authorization

string

header

required

JWT authentication token

Path Parameters

string<uuid>

required

Task ID

Body

application/json

decision

enum<string>

required

Whether to approve or decline the pending tool call

Available options:

approve,

decline

agent_id

string

Agent ID to resume (optional, resolved from stream metadata if omitted)

metadata

object

Answers or additional data to pass to the resumed tool (e.g., ask_question answers)

run_id

string

Agent run ID (optional, resolved from stream metadata if omitted)

tool_call_id

string

Specific tool call ID to approve (for parallel subagent routing)

Response

Approval processed successfully

success

boolean

required

error

string

Error message if approval failed

stream_id

string

ID of the resumed stream

Abort active task

Get task completion artifact

⌘I