Skip to main content
POST
/
finops
/
v1
/
approval-requests
/
{approval_request_id}
/
cancel
Cancel an approval request
curl --request POST \
  --url https://api.sandbox.tesouro.com/finops/v1/approval-requests/{approval_request_id}/cancel \
  --header 'Authorization: Bearer <token>' \
  --header 'x-finops-version: <x-finops-version>' \
  --header 'x-organization-id: <x-organization-id>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "approved_by": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "created_by": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
  "object_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "object_type": "account",
  "required_approval_count": 2,
  "status": "waiting",
  "user_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "rejected_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-finops-version
string<date>
required
​
x-organization-id
string<uuid>
required

The ID of the entity that owns the requested resource.

Example:

"9d2b4c8f-2087-4738-ba91-7359683c49a4"

Path Parameters

​
approval_request_id
string<uuid>
required

Response

Successful Response

​
id
string<uuid>
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
approved_by
string<uuid>[]
required
​
created_by
string<uuid>
required

ID of the user who created the approval request

Example:

"ea837e28-509b-4b6a-a600-d54b6aa0b1f5"

​
object_id
string<uuid>
required
​
object_type
enum<string>
required
Available options:
account,
accounting_tax_rate,
approval,
approval_request,
approval_policy,
approval_policy_process,
audit_trail,
comment,
cost_center,
counterpart,
counterpart_address,
counterpart_bank_account,
counterpart_contact_person,
counterpart_partner_metadata,
counterpart_tax_id,
counterpart_vat_id,
delivery_note,
einvoicing,
entity,
entity_bank_account,
entity_settings,
entity_token,
entity_user,
entity_user_token,
entity_vat_ids,
export,
ledger_account,
mailbox,
monitescript_process,
ocr_task,
onboarding,
overdue_reminder,
partner,
partner_internal_config,
partner_settings,
partner_token,
payable,
payable_line_item,
payables_credit_note,
payables_purchase_order,
payment,
payment_intent,
payment_link,
payment_record,
payment_reminder,
person,
product,
project,
receivable,
reconciliation,
recurrence,
receipt,
role,
tag,
todo_task,
todo_task_mute,
transaction,
webhook,
workflow,
workflow_pipeline
​
required_approval_count
integer
required
Required range: x >= 1
​
status
enum<string>
required
Available options:
waiting,
approved,
rejected,
canceled
​
user_ids
string<uuid>[]
required
​
rejected_by
string<uuid>