Skip to content

Request Cancellation

Request job cancellation.

Request cancellation for a job. If the cancellation request is approved, the job's status will change to CANCELLED.

This endpoint allows you to submit a cancellation request with a reason. The request will be reviewed and processed accordingly.

Endpoint

MethodUrl
POSTv1.0/jobs/{job_id}/request-cancellation

Url Parameters

job_id
guid

ID of the job to request cancellation for.

Sample Request

Copied
1curl -X POST 'https://api.worklayer.com/v1.0/jobs/499d692d-67aa-4127-a45c-b9e27f54afad/request-cancellation' \
2-H 'Authorization: Bearer {token}' \
3-H 'Content-Type: application/json' \
4-d '{
5 "requested_by_user_id": "7c4e2b1a-9d3f-4e5a-8b6c-3f7d8e9a1b2c",
6 "reason": "Client no longer needs tax preparation services"
7}'

Request Payload

requested_by_user_id
guid
required

ID of the user requesting cancellation.

reason
string
required

A clear explanation for why the job needs to be cancelled.

Response

An empty response indicates that the cancellation request was successfully submitted.

Sample Response

Copied
1{}
Last updated on August 8, 2025