---
title: "Update assignment status"
method: PATCH
path: "/v1/assignments/{assignmentId}"
tags: ["Assignments"]
---

# Update assignment status

`PATCH /v1/assignments/{assignmentId}`

## Request

- Base URL: `https://api.workwing.io`
- URL: `https://api.workwing.io/v1/assignments/{assignmentId}`
- Auth: HTTP bearer

Update the status of a job assignment

## Path parameters

- `assignmentId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `status` 'T_ASSIGNED' | 'T_ACKNOWLEDGED' | 'T_EN_ROUTE' | 'T_ON_SITE' | 'T_COMPLETED' | 'T_FAILED', required

## Response `200`

The updated assignment

- object: The updated assignment
  - `data` object, required
    - `id` string, uuid, required
    - `job_id` string, uuid, required
    - `parent_job_id` string, uuid, nullable, required: The project the job belongs to, if any.
    - `resource_id` string, uuid, required
    - `user_id` string, uuid, required: The user behind the resource
    - `customer_id` string, uuid, required
    - `status` 'T_ASSIGNED' | 'T_CONFIRMED' | 'T_ACKNOWLEDGED' | 'T_EN_ROUTE' | 'T_ON_SITE' | 'T_COMPLETED' | 'T_FAILED', required
    - `assigned_at` string, date-time, required
    - `assigned_by` string, uuid, nullable, required: The user who assigned it
    - `assigned_by_system` boolean, required: True when WorkWing made the assignment rather than a person.
    - `acknowledged_at` string, date-time, nullable, required
    - `en_route_at` string, date-time, nullable, required
    - `arrived_at` string, date-time, nullable, required
    - `notes` string, nullable, required
    - `route_position` integer, nullable, required
    - `estimated_travel_duration` integer, nullable, required
    - `estimated_travel_distance` integer, nullable, required
    - `travel_eta` string, date-time, nullable, required
    - `travel_estimated_at` string, date-time, nullable, required
    - `departure_latitude` number, nullable, required
    - `departure_longitude` number, nullable, required
    - `sync_expired_at` string, date-time, nullable, required: When the assignment stopped syncing to the mobile app after its job closed. Null while it still syncs.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required

---

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