---
title: "Updates a specific assignment"
method: PUT
path: "/assignments/{assignmentId}"
tags: ["Assignments"]
---

# Updates a specific assignment

`PUT /assignments/{assignmentId}`

## Path parameters

- `assignmentId` integer, required

## Request body

- UpdateAssignmentRequest
  - `customer_address_id` integer — The assignment customer addressid id
  - `title` string — The assignment title
  - `description` string — The assignment description
  - `to_be_documented` string — The assignment 'to be documented info'
  - `internal_info` string — The assignment 'internal planner note'
  - `site_notes` string — The assignment 'important hint'
  - `state` 'UNPLANNED' | 'SCHEDULED' | 'IN_PROGRESS' | 'PAUSED' | 'DELAYED' | 'DONE' — Assignment state
  - `all_day` boolean — The assignment all_day
  - `start` string, date-time — The assignment start
  - `end` string, date-time — The assignment end
  - `source` string — The assignment source
  - `source_external_id` string — The assignment source_external_id
  - `employees` integer[] — List of employee ids attached to this appointment
  - `vehicles` integer[] — List of vehicle ids attached to this appointment
  - `tools` integer[] — List of tool ids attached to this appointment
  - `documents` integer[] — List of document ids attached to this appointment
  - `tags` integer[] — List of label (assignment_tags) ids attached to this appointment
  - `articles` array[] — Articles, use index keys as article id and assign a subarray with key amount
    - object[]
      - `amount` integer — Planned amount of this article

## Response `200`

The request was successful.

## Other responses

- `401` — The request lacks valid authentication credentials.
- `403` — The token is valid but lacks the permission for this action.
- `404` — The requested resource could not be found.
- `422` — The request was well-formed but contains semantic errors (validation failed).
- `500` — An unexpected error occurred on the server (e.g. a requested relation does not exist).

---

[API](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation.md) · [All operations](https://skmtc.net/craftboxx/apis/craftboxx-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/craftboxx/craftboxx-api-documentation/versions/c01f07a02f77/schema)