Skip to main content
POST
/
v1
/
agents
/
{agentId}
/
tasks
/
{taskId}
/
resolve
Resolve a pending HITL approval (external approver)
curl --request POST \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/agents/{agentId}/tasks/{taskId}/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "approved": true
}
'
{
  "task_id": "<string>",
  "status": {},
  "resolved_by": "<string>"
}

Authorizations

​
Authorization
string
header
required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Path Parameters

​
agentId
string
required
Maximum string length: 64
​
taskId
string
required
Maximum string length: 128

Body

application/json
​
approved
boolean
required

Approve or reject the pending tool call.

​
reason
string

Optional rationale, surfaced in audit trail.

Maximum string length: 2048

Response

Resolved task summary.

​
task_id
string
​
status
object
​
resolution
enum<string>
Available options:
approved,
rejected
​
resolved_by
string