---
title: "Assign a resource to a job"
method: POST
path: "/v1/jobs/{jobId}/assignments"
tags: ["Assignments"]
---

# Assign a resource to a job

`POST /v1/jobs/{jobId}/assignments`

## Request

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

Assign a resource to a job. On a project, this adds the resource to the crew who may claim its jobs.

## Path parameters

- `jobId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `resource_id` string, uuid, required

## Response `201`

The new assignment

- object: The new 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)