Jobs

Update job

PUT update job

Endpoint

PUT /api/v1/jobs/:id

Parameters

Name Description
job[title] required Job title
job[drivers_required] required Job drivers required
job[industries] required Job industries
job[start_date] required Job start date
job[end_date] Job end date
job[ongoing] Job ongoing
job[postcode] required Job postcode
job[description] required Job description
job[licenses] Job licenses
job[min_rating] required Job min rating
job[young_drivers] Job young drivers
job[inexperienced_drivers] Job inexperienced drivers
job[job_type] required Job job type
job[show_by] required Job show by
job[expected_weekly_hours] Job expected weekly hours
job[hours_from] Job hours from
job[hours_to] Job hours to
job[wages_attributes] required Job wages attributes
job[overtime_after] Job overtime after
job[overtime_rate] Job overtime rate
job[dbs_check] Job dbs check
job[dbs_last_performed_months] Job dbs last performed months

Request

Route

PUT /api/v1/jobs/477

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMzM2Iiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzYzNjI2Mzk1LCJleHAiOjE3NjYyMTgzOTUsImp0aSI6IjQyZjQ5N2JmLTliM2YtNDE5NC04ODNhLThhNDk2ZjNmZWM0MyJ9.iy8dbqkUa2lEjT9P6iNpgNNpkvNnvkc_L9jypQKLfh0
Host: example.org
Cookie:

Body

{
  "job": {
    "id": 477,
    "number": 11411858,
    "title": "Lead Agent",
    "description": "Sto certo curtus. Caelum vulticulus harum.",
    "postcode": "B1 1AA",
    "industries": [
      "tourism",
      "medical"
    ],
    "drivers_required": 4,
    "start_date": "2025-11-28",
    "end_date": "2026-04-22",
    "job_type": "part_time",
    "show_by": "range_of_hours",
    "expected_weekly_hours": 40,
    "hours_from": 10,
    "hours_to": 20,
    "licenses": [
      "phv",
      "d1e"
    ],
    "status": "draft",
    "published_at": "2025-11-20T07:13:15.035Z",
    "longitude": -74.0059731,
    "latitude": 40.7143528,
    "created_at": "2025-11-20T08:13:15.036Z",
    "updated_at": "2025-11-20T08:13:15.041Z",
    "company_id": 474,
    "min_rating": "3.8",
    "min_rate": "76.5",
    "region": null,
    "young_drivers": false,
    "inexperienced_drivers": false,
    "overtime_after": null,
    "overtime_rate": null,
    "discarded_at": null,
    "dbs_check": "no",
    "dbs_last_performed_months": null,
    "timer": 86400,
    "webflow_id": null,
    "currency": "GBP",
    "wages_attributes": {
      "802": {
        "id": 802,
        "kind": "weekday",
        "rate": "85.0",
        "created_at": "2025-11-20T08:13:15.038Z",
        "updated_at": "2025-11-20T08:13:15.038Z",
        "wageable_type": "Job",
        "wageable_id": 477,
        "driver_rate": "76.5"
      }
    }
  }
}

Response

Simulated Response

Status

200

Headers

x-frame-options: SAMEORIGIN
x-xss-protection: 0
x-content-type-options: nosniff
x-permitted-cross-domain-policies: none
referrer-policy: strict-origin-when-cross-origin
content-type: application/json; charset=utf-8
vary: Accept, Origin
etag: W/"ec837d76e38c53dc8663d0115f5368d4"
cache-control: max-age=0, private, must-revalidate
x-request-id: bf4e7b3d-342a-4b36-9878-c12a3a42e133
x-runtime: 0.016159
content-length: 677

Body

{
  "job": {
    "id": 477,
    "chat": null,
    "currency": "GBP",
    "dbs_check": "no",
    "dbs_last_performed_months": null,
    "description": "Sto certo curtus. Caelum vulticulus harum.",
    "drivers_required": 4,
    "end_date": "2026-04-22",
    "expected_weekly_hours": null,
    "hours_from": 10,
    "hours_to": 20,
    "industries": [
      "tourism",
      "medical"
    ],
    "inexperienced_drivers": false,
    "job_type": "part_time",
    "licenses": [
      "phv",
      "d1e"
    ],
    "min_rating": "3.8",
    "number": 11411858,
    "overtime_rate": null,
    "postcode": "B1 1AA",
    "published_at": "2025-11-20T07:13:15.035Z",
    "show_by": "range_of_hours",
    "start_date": "2025-11-28",
    "status": "draft",
    "title": "Lead Agent",
    "wages": [
      {
        "id": 802,
        "driver_rate": null,
        "kind": "weekday",
        "rate": "85.0"
      }
    ],
    "young_drivers": false
  }
}