Approvals
Approve
POST
Approve the document or the time off, with an optional comment. Send an Idempotency-Key: the same key returns the same answer for 24 hours.
bearerheader
AuthorizationBearer <token>An access token from /v1/auth/token, or a personal token: opaque, beginning s2a_.
workspace_id*stringwsp_…, from GET /v1/me
Length
length <= 40approval_id*stringLength
length <= 40idempotency-key*stringA UUID of your own (ADR 0071 §5)
Match
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidapplication/json- body
comment?stringRequired to decline or ask for changes; optional to approve
Length
length <= 2000Decided
application/json- response
Decided
id*stringstatus*stringThe item’s state now: approved, declined, sent…
curl -X POST 'https://api.sign2approve.com/v1/workspaces/string/approvals/string/approve' \ -H 'idempotency-key: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "req_01a16d3fd3507be78e41c4540aa20a3c", "status": "approved"}