Delete a job listing
It is not possible to delete an existing job listing unless it has not been published. You can use this endpoint to send the listing status and the system will determine whether it can be deleted.
Endpoint
POST https://canadamotorjobs.com/api/v1/{locale}/job-listings/delete
URL parameters
| Parameter | Type | Description |
|---|---|---|
| job_listing_id | string | The unique job listing identifier |
| status | string: filled, expired, deleted | The job listing status |
The status can be:
filled: The position has been filled, applications are closed, but remains visible for the remaining display period.ended: The listing has expired, which will remove the listing from the sitedeleted: The listing has been deleted; switches toendedif published, otherwise it will be deleted immediately
Required headers
Authorization: Bearer your_access_token
Response codes
| Code | Description |
|---|---|
| 204 | Success - The listing has been deleted |
| 404 | Listing not found |
| 401 | Unauthorized |
| 403 | Access denied |
Important notes
- Deletion is permanent and cannot be undone
- All data associated with the listing will also be deleted
- Applications linked to this listing will be archived