Platitun · API · The deal · Set the work mode

Set the work mode

PUT /api/v1/work-mode

Key scope: orders · changes data, the Idempotency-Key header is required

Capacity, do-not-disturb and quiet hours can be set by a program. Hours are in UTC, like all time on the marketplace; converting them to the server’s local time is forbidden.

Quiet hours are set both or neither: a single hour would mean an interval with no end — you could not leave it, and the silence would be forever.

Request fields

Field	Type	What it is
`capacity` required	`integer`	How many orders to take at once, from 1 to 50.
`doNotDisturb`	`boolean`	A request not to be called.
`quietFromHour`	`integer`	Quiet hours start, UTC, 0–23.
`quietToHour`	`integer`	Quiet hours end, UTC, 0–23.

Response fields

Field	Type	What it is
`capacity`	`integer`	What it became.

Refusal reasons

A rule refusal arrives as {"error":"rejected","refusal":{"kind":"…"}} with status 409. Refusals common to all endpoints are in the rules section.

Code	What happened and what to do
`capacity_bad`	The capacity is outside the allowed range.
`quiet_hours_bad`	Quiet hours are set both or neither, and they must differ: a single hour would mean an interval with no end.

Nearby in this section

GET /api/v1/orders — My orders
GET /api/v1/orders/{id} — One order
POST /api/v1/orders/{id}/confirm — Take the order
POST /api/v1/orders/{id}/decline — Decline the order
POST /api/v1/orders/{id}/deliver — Mark the delivery
POST /api/v1/orders/{id}/messages — Message the buyer
GET /api/v1/orders/{id}/handover — The order vaults
POST /api/v1/orders/{id}/handover — Put credentials into a vault
POST /api/v1/orders/{id}/handover/reveal — Read the buyer’s vault
POST /api/v1/orders/{id}/dispute/reply — Answer a dispute
GET /api/v1/reviews — Reviews about me
POST /api/v1/reviews/{id}/reply — Reply to a review
GET /api/v1/complaints — My complaints
POST /api/v1/complaints — Complain about a buyer
GET /api/v1/work-mode — Work mode and presence