---
title: "Move the job along (sent → in_progress → done, or cancelled)"
method: POST
path: "/v3/fulfillment/jobs/{id}/status"
tags: ["Fulfillment"]
---

# Move the job along (sent → in_progress → done, or cancelled)

`POST /v3/fulfillment/jobs/{id}/status`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/fulfillment/jobs/{id}/status`
- Auth: API key in header `apikey`

When the last job of the order is done, the order becomes ready.

## Path parameters

- `id` integer, required

## Request body

- object
  - `status` 'sent' | 'in_progress' | 'done' | 'cancelled', required
  - `note` string, nullable

## Response `200`

The job

- ProductionJob
  - `id` integer
  - `order` object: List only
    - `id` integer
    - `number` string
    - `status` string
    - `client` string, nullable
    - `expected_delivery_at` string, date, nullable
  - `line` object
    - `id` integer
    - `name` string
    - `preview` string, nullable
    - `design_id` integer, nullable
  - `manufacturer_id` integer, nullable
  - `manufacturer_name` string, nullable
  - `kind` 'production' | 'rework'
  - `status` 'pending' | 'sent' | 'in_progress' | 'done' | 'cancelled'
  - `allowed_transitions` string[]
  - `quantity` integer
  - `stl_url` string, nullable
  - `stl_status` 'ready' | 'pending' | 'failed'
  - `stl_error` string, nullable
  - `tech_sheet` object: Piece, metal, size, engraving, stones, record, tech; no prices
  - `notes` string, nullable
  - `sent_at` string, date-time, nullable
  - `started_at` string, date-time, nullable
  - `done_at` string, date-time, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: INVALID_JOB_STATUS | INVALID_JOB_TRANSITION
- `404`: JOB_NOT_FOUND

## Changes

- **2026-10-19** `3448a5b6797c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/fulfillment/jobs/:id/status/post.md)

---

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