Skip to main content
PUT
Plan a round

Authorizations

Authorization
string
header
required

A pc_… token generated from Settings > API & MCP.

Path Parameters

day
string<date>
required

Local day key, YYYY-MM-DD.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
index
integer
required

Which round of the day, counting from zero.

Required range: 0 <= x <= 5

Body

application/json
taskIds
string<uuid>[]
required

In display order. Pass an empty array to clear the plan.

Maximum array length: 3

Identifier of a row.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
movedTaskIds
string<uuid>[]

The subset moved by this request and softly scheduled into the interval.

Required array length: 1 - 3 elements

Identifier of a row.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
roundEndMin
integer

Exclusive target interval end, in minutes after midnight.

Required range: 1 <= x <= 1440
roundStartMin
integer

Inclusive target interval start, in minutes after midnight.

Required range: 0 <= x <= 1439

Response

Success.

round
object
required
removedFromOtherRounds
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991