updateApproval

updateApproval

Overview

Update an approval.

This method is idempotent. This method is equivalent to a replace operation. For partial updates, use patchApproval.

An fm_approvals table lock is obtained during the execution of this API.

This method requires the Approvals:Update permission to be associated with your role.

It performs the same function as the corresponding action in the Approvals screen.

Permissions

The permission for this api is stored in [gb_api_permissions]permission as 'Approvals:Update'.

Only roles with a stored link to this permission in [gb_role_api_permissions] can run this api.

HTTP Method

Use the HTTP Method 'PUT' for consuming this web service.

URL Examples

https://api.demo.catch-e.com/fm/approvals/{approval_id}

https://api.{{environment}}.catch-e.com/fm/approvals/{approval_id}

https://api.test.catch-e.com/fm/approvals/{approval_id}

Input Fields (Path)

Key

Format

Notes

Mandatory

approval_id

string

Approval Id

Yes

Input Fields (Header)

Key

Format

Notes

Mandatory

Delegated-Locking-Session-Id

string

(Optional) Locking responsibility will be delegated to the specified Session Id. This header enables the client to instruct the API to merely verify the presence of locks with the specified session id, but not attempt to obtain them itself. It requires the DelegatedLocking permission to be associated with your role.

No

Audit-User-Id

string

(Optional) User Id to use for audit purposes. This header requires the Audit:UserIdOverride permission to be associated with your role.

No

Time-Zone

string

Approvals will be processed in the specified timezone. The timezone value can be given in several formats, none of which are case sensitive: - As a named time zone, such as 'Europe/Helsinki', 'US/Eastern', or 'MET'. - As a string indicating an offset from UTC of the form [H]H:MM, prefixed with a + or -, such as '+10:00', '-6:00', or '+05:30'. A leading zero can optionally be used for hours values less than 10;

No

Input Fields (JSON)

{  "approval_limit": 0,  "approval_sub_status_id": "string",  "attachment_id": "string",  "bank_details_correct_flag": "no",  "billing_period": 0,  "billing_period_item_no": 0,  "client_phone": "string",  "contract_id": "string",  "credit_note_flag": "no",  "driver_aware_flag": "no",  "driver_bank_account_id": "string",  "driver_name": "string",  "driver_phone": "string",  "external_order_number": "string",  "invoice_date": "2026-07-25",  "invoice_no": "string",  "misc_phone": "string",  "notes": "string",  "franchise_notes": "string",  "odometer": 0,  "odometer_date": "2026-07-25",  "odometer_valid_flag": "valid",  "payee_payment_method_id": "string",  "reimbursement_flag": "no",  "status_flag": "active",  "supplier_contact": "string",  "supplier_franchise_vehicle_id": "string",  "supplier_id": "string",  "supplier_phone": "string",  "maintenance_lines": [  {  "maintenance_id": "string",  "job_number": 0,  "posting_class_id": "string",  "vmrs_code_id": "string",  "work_code_id": "string",  "cause_code_id": "string",  "type": "P",  "recharge_flag": "Y",  "description": "string",  "quantity": 0,  "retail_price": 0,  "cost_price": 0,  "gst_cost": 0  }  ] }

Response Details

Success

200 - Approval updated successfully

{  "approval_id": "string",  "contract_id": "string",  "user_id": "string",  "supplier_id": "string",  "supplier_franchise_vehicle_id": "string",  "supplier_contact": "string",  "supplier_phone": "string",  "payee_payment_method_id": "string",  "driver_bank_account_id": "string",  "driver_name": "string",  "driver_phone": "string",  "client_phone": "string",  "misc_phone": "string",  "notes": "string",  "franchise_notes": "string",  "invoice_no": "string",  "invoice_date": "2026-07-25",  "billing_period": 0,  "reimbursement_flag": "no",  "driver_aware_flag": "no",  "odometer": 0,  "odometer_date": "2026-07-25",  "odometer_valid_flag": "string",  "bank_details_correct_flag": "no",  "attachment_id": "string",  "source": "internal",  "external_order_number": "string",  "approval_limit": 0,  "created": "2026-07-25",  "last_edit": "2026-07-25",  "user_id_edit": "string",  "posted_date": "2026-07-25",  "credit_note_flag": "no",  "approval_sub_status_id": "string",  "requested_audit_attempt_count": 0,  "status_flag": "string",  "maintenance_lines": [  {  "maintenance_id": "string",  "job_number": 0,  "posting_class_id": "string",  "vmrs_code_id": "string",  "work_code_id": "string",  "cause_code_id": "string",  "type": "P",  "recharge_flag": "Y",  "description": "string",  "quantity": 0,  "retail_price": 0,  "cost_price": 0,  "gst_cost": 0  }  ] }

Error Response Details

Validation Message

Comments

401 Unauthorized

1. You have not authenticated before running this API or
2. The token_timeout of the current session has passed. You need to authenticate again.

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Unauthorized",  "status": 401,  "detail": "Unauthorized" }

Validation Message

Comments

403 Forbidden

- You do not have permissions for this request.
- Go to System Roles and enter 'web_services'
- Navigate to the Roles / APIs tab to make sure the permission you need to run this API is checked.

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Forbidden",  "status": 403,  "detail": "Forbidden" }

Validation Message

Comments

404 - Liability Not Found

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Liability Not Found",  "status": 404,  "detail": "Liability Not Found" }

Validation Message

Comments

406 - Not Acceptable

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Not Acceptable",  "status": 406,  "detail": "Not Acceptable" }

Validation Message

Comments

415 - Unsupported Media Type

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Unsupported Media Type",  "status": 415,  "detail": "Not Acceptable" }

Validation Message

Comments

422 - Unprocessible Entity

- Data being passed in the described field is invalid, the format is invalid or it is missing

{  "warning_messages": {  "fieldName": {  "warningExceptionCode": "A textual description of the warning exception"  }  },  "validation_messages": {  "fieldName": {  "validationExceptionCode": "A textual description of the validation exception"  }  },  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "Unprocessable Entity",  "status": 422,  "detail": "Failed Validation" }

Validation Message

Comments

500 - Internal Error

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "string",  "status": 599,  "detail": "string" }

Validation Message

Comments

default - Unexpected Error

{  "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",  "title": "string",  "status": 599,  "detail": "string" }