Skip to main content
POST
/
schedule
/
v1
/
planners
/
{plannerId}
/
free-days
Assign Free Days to Employees in Planner
curl --request POST \
  --url https://api-{region}.sesametime.com/schedule/v1/planners/{plannerId}/free-days \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "2026-02-10",
  "to": "2026-02-12",
  "employeeIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "comments": "Personal day",
  "ranges": [
    {
      "from": "09:00",
      "to": "14:00"
    }
  ]
}
'
{
  "data": "",
  "meta": {
    "currentPage": 1,
    "lastPage": 1,
    "total": 1,
    "perPage": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidocs.sesametime.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
plannerId
string<uuid>
required

The planner ID

Body

application/json
​
from
string<date>
required

Start of the range (Y-m-d). Inclusive.

Example:

"2026-02-10"

​
to
string<date>
required

End of the range (Y-m-d). Inclusive. Max range: 3 years.

Example:

"2026-02-12"

​
employeeIds
string<uuid>[]
required

Employees to assign the free days to.

​
comments
string | null

Optional comments attached to each free day.

Maximum string length: 255
Example:

"Personal day"

​
ranges
object[] | null

Optional time ranges that define partial free days. Must not overlap and must total less than 24 hours.

Response

Object

​
data
string
Example:

""

​
meta
object