Update job status

PATCH

/jobs/{jobId}/status

Change an existing job to a supported lifecycle state. This does not change publication settings.

Permissions

jobs.status.write and an Idempotency-Key are required.

Supported states

Code	State
1	Draft
2	New
4	Rejected
5	In Progress (active)

Codes 2 and 4 do not mean Closed or On Hold. Use job options to discover supported values.

Before activating

Complete the required job details and skills. Complete older incomplete drafts in CVViZ first.

Complete any required job approval in CVViZ.

Ensure active-job capacity is available.

Activation clears the draft flag; other status changes preserve it. This endpoint does not approve a job or publish it to job boards.

See Create and activate a job for the full workflow.

Common errors

400: invalid state or incomplete job details.

409: approval, capacity or idempotency conflict.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Mutation applied or safely replayed.

Headers

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠429

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.cvviz.com/v1/jobs//status' \
--header 'Idempotency-Key: cvviz-integration-operation-001' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "status": 1,
    "remarks": "string"
}'

Response Example

200 - Example 1

{
    "data": {
        "id": 901,
        "status": 5,
        "isDraft": false,
        "isDeleted": false
    }
}

Update a candidate application stage

List candidates

Update job status

Permissions#

Supported states#