Skip to main content
Add or remove invoice approvers

Authorizations

Authorization
string
header
required

Personal API key sent as a bearer token, together with X-Organization-Id. The key must have at least the access level the endpoint requires (read, write or admin).

Headers

X-Organization-Id
string

The organization to act in. Required for personal API keys; list the organizations you can access with GET /v1/organizations.

Body

application/json
ids
string<uuid>[]
required

The invoices to change, at most 100. For one invoice, send its ID alone.

Required array length: 1 - 100 elements
add_user_ids
string[]

Members to add as approvers to every invoice: members with write access who can see each one.

Maximum array length: 20
Required string length: 1 - 255
remove_user_ids
string[]

People to remove as approvers from every invoice.

Maximum array length: 20
Required string length: 1 - 255
add_team_ids
string<uuid>[]

Teams to add as approvers to every invoice: each counts as one approver, and any member with write access who can see the invoice may decide for it. Each needs such a member for every invoice.

Maximum array length: 20
remove_team_ids
string<uuid>[]

Teams to remove as approvers from every invoice.

Maximum array length: 20

Response

How many invoices changed.

changed_count
integer
required

Invoices whose approvers changed. Invoices already as requested are not counted.