Update Job

Update a job’s status or details

PATCH /jobs/{id}

cURL

approve_job

curl --request PATCH \ --url https://api.kardow.com/jobs/{id} \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data ' { "status": "active" } '

200

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "updated_at": "2023-11-07T05:31:56Z",
    "title": "<string>",
    "company_name": "<string>",
    "status": "<string>",
    "location": "<string>",
    "is_remote": true
  }
}

Update one or more fields on an existing job. Commonly used to approve pending jobs or change status.

Path Parameters

id · string · required

The job UUID.

Request Body

At least one field is required.

status · string

New status: active, draft, pending, or expired.

title · string

Updated job title.

description · string

Updated job description.

location · string

Updated location.

is_remote · boolean

Updated remote setting.

Examples

Approve a pending job

cURL

curl --request PATCH \
  --url "https://api.kardow.com/jobs/550e8400-e29b-41d4-a716-446655440000" \
  --header "x-api-key: your-api-key-here" \
  --header "Content-Type: application/json" \
  --data '{"status": "active"}'

Response

data · object

Show properties

id · string

Job ID

title · string

Job title

company_name · string

Company name

status · string

Updated status

updated_at · string

ISO 8601 timestamp

Authorizations

x-api-key · string · header · required

API key for authentication. Get yours from Settings > API Keys in the Kardow dashboard.

Path Parameters

id · string<uuid> · required

Job UUID.

Body

application/json

status · enum<string>

Available options: active, draft, pending, expired

title · string

Required string length: 1 - 255

description · string

Minimum string length: 1

location · string

is_remote · boolean

Response

200

application/json

Job updated

data · object · required

Show child attributes