---
title: "Update a job"
method: PATCH
path: "/jobs/{job_id}"
tags: ["Jobs"]
---

# Update a job

`PATCH /jobs/{job_id}`

## Request

- Base URL: `https://api.tidy.com/v1`
- URL: `https://api.tidy.com/v1/jobs/{job_id}`
- Auth: API key in header `X-API-Key`

Update job details

## Path parameters

- `job_id` integer, required

## Request body

- JobUpdate
  - `scheduled_at` string, date-time
  - `notes` string
  - `status` 'pending' | 'confirmed' | 'in_progress' | 'completed' | 'cancelled'

## Response `200`

Job updated successfully

- Job
  - `id` integer: Unique job identifier
  - `address_id` integer: The address where the job will be performed
  - `pro_id` integer, nullable: The pro assigned to this job
  - `service_type` 'cleaning' | 'maintenance' | 'inspection' | 'restocking': Type of service
  - `status` 'pending' | 'confirmed' | 'in_progress' | 'completed' | 'cancelled'
  - `scheduled_at` string, date-time: When the job is scheduled to start
  - `completed_at` string, date-time, nullable
  - `price` number, float: Job price in USD
  - `notes` string, nullable: Additional notes for the pro
  - `created_at` string, date-time
  - `updated_at` string, date-time

---

[API](https://skmtc.dev/tidy/apis/tidy-api.md) · [All operations](https://skmtc.dev/tidy/apis/tidy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tidy/apis/tidy-api/revisions/c13f59ecd759?raw)