ApiJob Listings
Delete a job listing
Permanently deletes a job listing. Only listings in `DRAFT` or `ARCHIVED` status can be deleted. Requires scope: `jobs:write`
Permanently deletes a job listing. Only listings in DRAFT or ARCHIVED status can be deleted.
Requires scope: jobs:write
Authorization
ApiKeyAuth X-API-Key<token>
API key issued by Jobiflow. Pass it in the X-API-Key request header.
Create keys via the company dashboard (Settings → API Keys) or via POST /settings/api-keys.
In: header
Path Parameters
id*string
UUID of the job listing to delete.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/public/v1/job-listings/497f6eca-6276-4993-bfeb-53cbbbba6f08"Empty
{
"status": 401,
"error": "UNAUTHORIZED",
"message": "Invalid or missing API key",
"timestamp": "2026-05-17T12:00:00Z",
"path": "/public/v1/job-listings"
}{
"status": 403,
"error": "FORBIDDEN",
"message": "Scope 'jobs:write' is required",
"timestamp": "2026-05-17T12:00:00Z",
"path": "/public/v1/job-listings"
}{
"status": 404,
"error": "NOT_FOUND",
"message": "Job listing not found",
"timestamp": "2026-05-17T12:00:00Z",
"path": "/public/v1/job-listings/00000000-0000-0000-0000-000000000000"
}{
"status": 409,
"error": "CONFLICT",
"message": "Cannot delete an ACTIVE job listing",
"timestamp": "2026-05-17T12:00:00Z",
"path": "/public/v1/job-listings/abc"
}