Create an approval request

Returns immediately with an event_id; poll the result endpoint by it for the decision.

AuthorizationBearer

Organization-scoped API key.

This endpoint expects an object.

projectNamestringRequired>=1 character

Slug of an existing project (create it ahead of time)

summarystringRequired>=1 character

Human-readable summary of the action needing approval

taskIdstringRequired

Target task — create one via POST /tasks first

attachmentslist of stringsOptional

Upload ids of attached files to render for this request (must already be attached to the task)

externalTraceIdstringOptional

Optional link to the agent author's observability trace

keyValueContextmap from strings to stringsOptional

Display context as a plain key→value object (order/dup-keys are the client’s concern)

recommendationobjectOptional

Created

$	curl -X POST https://api.pumpup.com/api/approval-requests \
>	-H "Idempotency-Key: Idempotency-Key" \
>	-H "X-API-Version: X-API-Version" \
>	-H "Authorization: Bearer <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"projectName": "claims_refund_v1",
>	"summary": "Refund $240 on claim C-1029",
>	"taskId": "string"
>	}'