Approvals

Approvals hold money-moving actions until a second person decides on them. For how the feature works, see Approvals.

Policies

List policies

GET /v1/approvals/policies

Returns one policy per action, with a label and whether the action hasAmount:

{
  "data": [
    {
      "action": "credit.grant",
      "label": "Grant a credit",
      "hasAmount": true,
      "enabled": true,
      "thresholdAmount": 500,
      "thresholdCurrency": "USD",
      "updatedAt": "2026-10-13T09:00:00.000Z"
    }
  ]
}

Update a policy

PUT /v1/approvals/policies/:action

Only workspace admins can change policies. Unknown actions return 404.

Field	Type	Required	Description
`enabled`	boolean	Yes	Whether the action needs approval.
`thresholdAmount`	number or `null`	No	Only amounts at or above this need approval. `null` applies to every amount.
`thresholdCurrency`	string or `null`	No	Three-letter ISO code.

The action must be one of credit.grant, invoice.void, invoice.credit_note, or subscription.cancel.

Requests

List requests

GET /v1/approvals

Returns pending and past requests, most recent first.

Get a request

GET /v1/approvals/:id

Returns 404 if the request isn’t in your workspace.

Approve

POST /v1/approvals/:id/approve

{ "note": "Matches the signed credit agreement" }

note is optional, up to 1000 characters.

Reject

POST /v1/approvals/:id/reject

{ "note": "Amount doesn't match the order" }

note is optional, up to 1000 characters. A rejected request doesn’t run.

Status values

pending, approved, executing, executed, failed, rejected, expired. See the lifecycle.

Get started

Concepts

Tutorials

Guides

Enterprise

SDKs and tools

API reference

Contributing

Policies

List policies

Update a policy

Requests

List requests

Get a request

Approve

Reject

Status values

​Policies

​List policies

​Update a policy

​Requests

​List requests

​Get a request

​Approve

​Reject

​Status values

Policies

List policies

Update a policy

Requests

List requests

Get a request

Approve

Reject

Status values