Skip to main content
POST
Record an approval action in expense history

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

transaction_id
string<uuid>
required

Body

application/json
acted_at
string<date-time>
required

Timestamp when this specific action was performed.

action
string
required

The approval action performed: 'approved' or 'rejected'.

Required string length: 1 - 30
approval_policy_id
string<uuid>

Approval policy ID.

approval_policy_name
string

Approval policy name.

Maximum string length: 255
approval_policy_process_id
string<uuid>

Approval policy process ID.

approval_request_id
string<uuid>

Approval request ID from approval-requests.

approval_source
string
default:policy

Source of the action. Typically 'policy'.

entity_user_id
string<uuid>

The user who performed the action.

reject_reason
string

Reason for rejection, if applicable.

Required string length: 1 - 1024

Response

Successful Response

status
string
required

Creation status. Always 'created'.