Vacation Tracker Docs
REST API v2API referenceLeave types

List leave types

This API method returns the leave types of the company, active and inactive, in one response without pagination. Requires `leave-types:read`. Leave types are not limited by the key's data reach. Which locations use a leave type is returned by `GET /v2/locations/{id}/leave-policies`.

GET
/v2/leave-types

Authorization

bearerAuth leave-types:read
AuthorizationBearer <token>

API key sent as Authorization: Bearer vt_live_<secret>. See the Authentication and Scopes sections at the top of this document for how keys are created, which scopes exist and how the key owner's role limits them.

In: header

Scope: leave-types:read

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/leave-types"
{
  "data": [
    {
      "id": "leaveType-fcc1e5c5-ba93-479d-bd58-8f860ba10615",
      "name": "Vacation",
      "isActive": true,
      "color": "#1E90FF",
      "position": 0,
      "calendarStatus": "Busy"
    },
    {
      "id": "leaveType-88681ca1-4a47-4e4d-bc35-ffff86c0f54e",
      "name": "Sick leave",
      "isActive": true,
      "color": "#FF6347",
      "position": 1
    }
  ]
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "name": "Unauthorized",
    "description": "The API key is missing, malformed or not recognized.",
    "resolution": "Send a valid API key in the Authorization header as Bearer followed by the full vt_live_ key.",
    "requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef"
  }
}

{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "name": "InsufficientScope",
    "description": "The API key does not have the scopes this request needs.",
    "resolution": "Add the scopes listed in details.requiredScopes to the key in the Vacation Tracker dashboard.",
    "requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef",
    "details": {
      "requiredScopes": [
        "leaves:write"
      ]
    }
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "name": "RateLimited",
    "description": "Too many requests were sent in a short time.",
    "resolution": "Wait a few seconds and retry, using the same Idempotency-Key for writes.",
    "requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef"
  }
}
{
  "error": {
    "code": "INTERNAL_ERROR",
    "name": "InternalError",
    "description": "Something went wrong on our side.",
    "resolution": "Retry later, and if it keeps happening, contact Vacation Tracker support and quote the requestId.",
    "requestId": "c6af9ac6-7b61-11e6-9a41-93e8deadbeef"
  }
}

Need help?

developers@vacationtracker.io

Delete a label

This API method deletes a label. Requires `labels:write`. No request body. The acting user is the key owner, or the `X-On-Behalf-Of` user. It waits for the deletion and returns `204`, or `202 Accepted` with an operation to poll. Every user who has this label loses it. Errors: `403 ON_BEHALF_OF_NOT_ALLOWED`, `403 FORBIDDEN`, `404 RESOURCE_NOT_FOUND` (the label does not exist), and the `Idempotency-Key` codes.

Create a leave type

This API method creates a leave type and can enable it in locations right away. Requires `leave-types:write`. The acting user is the key owner, or the `X-On-Behalf-Of` user. It waits for the leave type to be created and returns it with `201`, or `202 Accepted` with an operation to poll. - `name` (1 to 32 characters) and `color` (`#RRGGBB`) are required. `isActive` defaults to `true`. - **Creating a leave type enables a leave policy in every location in `locationIds`**, all with the settings of `initialPolicy`. Every `initialPolicy` field has a default (a quota of 0 days, full-day leaves, approval required), so check it before you send `locationIds`. `locationIds` defaults to an empty array, which enables the leave type nowhere. - The policies are enabled in the background after the leave type is created, so they are not part of the response; read `GET /v2/locations/{id}/leave-policies` to confirm them, and change them with `PUT` or `PATCH /v2/locations/{id}/leave-policies/{leaveTypeId}`. - Unknown fields fail validation. Errors: `400 VALIDATION_ERROR` (`details.fields`), `400 INVALID_REQUEST_BODY`, `403 ON_BEHALF_OF_NOT_ALLOWED`, `403 FORBIDDEN`, `409 DUPLICATE_NAME` (another leave type already uses the name), `422 PLAN_LIMIT_REACHED`, and the `Idempotency-Key` codes.