Departments | absentify- api-doc

Get all departments

GEThttps://api.absentify.com/api/v1/departments

Authorization

Response

Successful response

Body

id*string

name*string

createdAt*string (date-time)

updatedAt*string (date-time)

approval_process*enum

Linear_all_have_to_agreeLinear_one_has_to_agreeParallel_all_have_to_agreeParallel_one_has_to_agree

maximum_absent*nullable number

members*array of object

Request

const response = await fetch('https://api.absentify.com/api/v1/departments', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "id": "text",
    "name": "text",
    "createdAt": "2024-09-07T19:57:58.813Z",
    "updatedAt": "2024-09-07T19:57:58.813Z",
    "approval_process": "Linear_all_have_to_agree",
    "maximum_absent": 0,
    "members": [
      {
        "id": "text",
        "name": "text",
        "email": "text",
        "custom_id": "text",
        "manager_type": "Member"
      }
    ]
  }
]

Create a department

POSThttps://api.absentify.com/api/v1/departments

Authorization

Body

name*string

default_allowance*number

maximum_absent*number

approval_process*enum

Linear_all_have_to_agreeLinear_one_has_to_agreeParallel_all_have_to_agreeParallel_one_has_to_agree

manager_member*array of object

default_department_allowances*array of object

Response

Successful response

Body

string (uuid)

Request

const response = await fetch('https://api.absentify.com/api/v1/departments', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "default_allowance": 0,
      "maximum_absent": 0,
      "approval_process": "Linear_all_have_to_agree",
      "manager_member": [
        {
          "member_id": "text",
          "predecessor_manager_id": "text"
        }
      ],
      "default_department_allowances": [
        {
          "id": "text",
          "value": 0
        }
      ]
    }),
});
const data = await response.json();

Response

123e4567-e89b-12d3-a456-426614174000

Read a department by id

GEThttps://api.absentify.com/api/v1/departments/{id}

Authorization

Path parameters

id*string (uuid)

Response

Successful response

Body

id*string

name*string

createdAt*string (date-time)

updatedAt*string (date-time)

approval_process*enum

Linear_all_have_to_agreeLinear_one_has_to_agreeParallel_all_have_to_agreeParallel_one_has_to_agree

maximum_absent*nullable number

members*array of object

Request

const response = await fetch('https://api.absentify.com/api/v1/departments/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "id": "text",
  "name": "text",
  "createdAt": "2024-09-07T19:57:58.813Z",
  "updatedAt": "2024-09-07T19:57:58.813Z",
  "approval_process": "Linear_all_have_to_agree",
  "maximum_absent": 0,
  "members": [
    {
      "id": "text",
      "name": "text",
      "email": "text",
      "custom_id": "text",
      "manager_type": "Member"
    }
  ]
}

Update a department

PUThttps://api.absentify.com/api/v1/departments/{id}

Authorization

Path parameters

id*string (uuid)

Body

namestring

maximum_absentnumber

approval_processenum

Linear_all_have_to_agreeLinear_one_has_to_agreeParallel_all_have_to_agreeParallel_one_has_to_agree

manager_memberarray of object

default_department_allowances*array of object

Response

Successful response

Body

string (uuid)

Request

const response = await fetch('https://api.absentify.com/api/v1/departments/{id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "default_department_allowances": [
        {
          "id": "text",
          "value": 0
        }
      ]
    }),
});
const data = await response.json();

Response

123e4567-e89b-12d3-a456-426614174000

Delete a department

DELETEhttps://api.absentify.com/api/v1/departments/{id}

Authorization

Path parameters

id*string (uuid)

Response

Successful response

Body

nullable enum

null

Request

const response = await fetch('https://api.absentify.com/api/v1/departments/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

null