v2

latestSwagger 2.02026-07-26109144190.4 KB
Rotations

Create a rotation group

Create a new rotation group under the specified team, optionally including one or more shifts.

Each shift must have a duration of 90 days or less. All usernames provided must belong to the organization and must not be stakeholder users.

The "shifttype" field must be one of: "std" (Standard), "fts" (Follow The Sun), "cstm" (Custom), "pho" (Period Hand Off). The "mask2" and "mask3" properties are optional and are used for "cstm" and "fts" shift types.

This API may be called a maximum of 2 times per second.

post/api-public/v1/teams/{team}/rotations

Path parameters

teamstring required

The team slug

Query parameters

skipinteger

Number of weeks to skip for the on-call period preview

countinteger

Number of weeks to show for the on-call period preview

Headers

X-VO-Api-Idstring required

Your API ID

X-VO-Api-Keystring required

Your API Key

Request body

labelstring required

The name of the rotation group

Response

The created rotation group with its shifts and on-call period details

orgslugstring

The organization slug

teamslugstring

The team slug

idinteger

The rotation group ID

labelstring

The name of the rotation group