cURL

curl -X DELETE 'https://api.sesamehr.com/schedule/v1/absence-day-off/f8628a31-08d6-47cf-bcdc-bac5a5fc9c82' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "dayOffIds": [
      "a4185f6c-2c7c-4933-9110-989dcad882fe",
      "e882aa04-eb54-44f3-a483-0aa4c1f048fd"
    ]
  }'

import requests

url = "https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}"

payload = { "dayOffIds": ["a4185f6c-2c7c-4933-9110-989dcad882fe"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({dayOffIds: ['a4185f6c-2c7c-4933-9110-989dcad882fe']})
};

fetch('https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'dayOffIds' => [
        'a4185f6c-2c7c-4933-9110-989dcad882fe'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}"

	payload := strings.NewReader("{\n  \"dayOffIds\": [\n    \"a4185f6c-2c7c-4933-9110-989dcad882fe\"\n  ]\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dayOffIds\": [\n    \"a4185f6c-2c7c-4933-9110-989dcad882fe\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dayOffIds\": [\n    \"a4185f6c-2c7c-4933-9110-989dcad882fe\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": "",
  "meta": {
    "currentPage": 1,
    "lastPage": 1,
    "total": 1,
    "perPage": 1
  }
}

Absence Day Off

Delete Absence Days Off from Calendar

Removes one or more absence days off from a specific calendar.

Overview

This endpoint allows authorized users to delete multiple absence days off in a single request by providing an array of day off IDs..

Important Behavior

Atomic Operation: The deletion is atomic - if any validation fails, no days off will be deleted. This ensures data consistency.
Ownership Validation: Each day off ID must belong to the specified calendar. Days off that exist but belong to a different calendar will cause the entire operation to fail.
Empty Response: On success, the endpoint returns an empty response with HTTP 200 status code.

DELETE

schedule

absence-day-off

{calendarId}

cURL

curl -X DELETE 'https://api.sesamehr.com/schedule/v1/absence-day-off/f8628a31-08d6-47cf-bcdc-bac5a5fc9c82' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "dayOffIds": [
      "a4185f6c-2c7c-4933-9110-989dcad882fe",
      "e882aa04-eb54-44f3-a483-0aa4c1f048fd"
    ]
  }'

import requests

url = "https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}"

payload = { "dayOffIds": ["a4185f6c-2c7c-4933-9110-989dcad882fe"] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({dayOffIds: ['a4185f6c-2c7c-4933-9110-989dcad882fe']})
};

fetch('https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'dayOffIds' => [
        'a4185f6c-2c7c-4933-9110-989dcad882fe'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}"

	payload := strings.NewReader("{\n  \"dayOffIds\": [\n    \"a4185f6c-2c7c-4933-9110-989dcad882fe\"\n  ]\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"dayOffIds\": [\n    \"a4185f6c-2c7c-4933-9110-989dcad882fe\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-{region}.sesametime.com/schedule/v1/absence-day-off/{calendarId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"dayOffIds\": [\n    \"a4185f6c-2c7c-4933-9110-989dcad882fe\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": "",
  "meta": {
    "currentPage": 1,
    "lastPage": 1,
    "total": 1,
    "perPage": 1
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

calendarId

string<uuid>

required

The unique identifier (UUID v4) of the calendar from which absence days off will be deleted.

Requirements:

Must be a valid UUID v4 format
The calendar must exist in the system
The authenticated user must have permission to modify this calendar

Body

application/json

Request body containing the array of absence day off IDs to be deleted from the calendar.

Note: All day off IDs must belong to the calendar specified in the path parameter.

dayOffIds

string<uuid>[]

required

Array of absence day off UUIDs to remove from the calendar.

Validation Rules:

Must be an array (can be empty)
Each element must be a valid UUID v4 string
Each UUID must correspond to an existing day off in the system
Each day off must belong to the calendar specified in the path parameter

Behavior:

Empty arrays are allowed and result in no changes
Duplicate IDs are processed without error
Order of IDs does not affect the operation

Unique identifier (UUID v4) of the absence day off to delete

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$

Example:

[
  "a4185f6c-2c7c-4933-9110-989dcad882fe",
  "e882aa04-eb54-44f3-a483-0aa4c1f048fd"
]

Response

Object

data

string

Example:

""