Deputy Unavail API

V1 /my/unavail/* endpoints

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /my/unavail Record my own unavailability · Create or update Unavail #
Ask an LLM
“How do I record a time off block on my own availability?”
“Can I create or update my own unavailabilities?”
Tell an agent
Create or update my own unavailability.
Record my personal time off block.
GET /my/unavail/{startDate}/{endDate} Get my unavailability for a period · GET Unavail / )?(:endDate)? #
Ask an LLM
“What time off have I recorded for a given week?”
“Can I see my own unavailability between two dates?”
Tell an agent
Show my unavailability from {startDate} to {endDate}.
List my own time off for {startDate} through {endDate}.
PUT /my/unavail/{unavailId} Update my own unavailability · PUT Unavail / :unavailId #
Ask an LLM
“How do I edit an unavailability block I created?”
“Can I change the dates of my own time off?”
Tell an agent
Update my unavailability {unavailId}.
Edit my own time off block {unavailId}.
DELETE /my/unavail/{unavailId} Delete my own unavailability · DELETE Unavail / :unavailId #
Ask an LLM
“How do I remove a time off block I recorded?”
“Can I delete my own unavailability?”
Tell an agent destructive · confirm first
Delete my unavailability {unavailId}.
Remove my own time off block {unavailId}.
POST /supervise/unavail Record an employee's unavailability · Create or update Unavail #
Ask an LLM
“How do I record a staff member's time off?”
“Can I create or update an employee's unavailability?”
Tell an agent
Create or update an employee's unavailability.
Record a staff member's time off block.
GET /supervise/unavail/{intEmployeeId} Get an employee's unavailability · GET Unavail / (:intEmployeeId)? #
Ask an LLM
“What time off has a staff member recorded?”
“Can I see one employee's unavailability for a period?”
Tell an agent
Show unavailability for employee {intEmployeeId}.
List staff member {intEmployeeId}'s time off.
PUT /supervise/unavail/{unavailId} Edit an unavailability record · PUT Unavail / :unavailId #
Ask an LLM
“Where can I edit an existing staff unavailability record?”
“Can I change an unavail record through the API?”
Tell an agent
Update unavail record {unavailId}.
Edit the unavailability {unavailId} on staff.
DELETE /supervise/unavail/{unavailId} Delete an unavailability record · DELETE Unavail / :unavailId #
Ask an LLM
“How do I delete a staff unavailability record?”
“Can I remove an unavail entry by its ID?”
Tell an agent destructive · confirm first
Delete unavail record {unavailId}.
Remove the staff unavailability {unavailId}.

Specifications

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/deputy:deputy-unavail-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

deputy-unavail-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Deputy Unavail API
  version: 1.0.0
  description: 'Operations tagged Unavail across 2 of this provider''s published API definitions: deputy-openapi.json, deputy-unavail-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{subdomain}.{region}.deputy.com/api/v1
  description: Deputy tenant
  variables:
    subdomain:
      default: your-subdomain
    region:
      default: deputy
      enum:
      - au
      - eu
      - na
      - deputy
security:
- BearerAuth: []
tags:
- name: Unavail
  description: V1 /my/unavail/* endpoints
paths:
  /my/unavail:
    post:
      tags:
      - Unavail
      summary: Create or update Unavail
      operationId: my_unavail__post
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Not authenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Not found
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
    servers:
    - url: https://{subdomain}.{region}.deputy.com/api/v1
      description: Deputy tenant
      variables:
        subdomain:
          default: your-subdomain
        region:
          default: deputy
          enum:
          - au
          - eu
          - na
          - deputy
  /my/unavail/{startDate}/{endDate}:
    get:
      tags:
      - Unavail
      summary: GET Unavail / )?(:endDate)?
      operationId: my_unavail__startdate_enddate__get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Not authenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Not found
      parameters:
      - name: startDate
        in: path
        required: true
        schema:
          type: string
          pattern: '[0-9]{2,4}\-[0-9]{1,2}\-[0-9]{1,2}'
      - name: endDate
        in: path
        required: true
        schema:
          type: string
          pattern: '[0-9]{2,4}\-[0-9]{1,2}\-[0-9]{1,2}'
    servers:
    - url: https://{subdomain}.{region}.deputy.com/api/v1
      description: Deputy tenant
      variables:
        subdomain:
          default: your-subdomain
        region:
          default: deputy
          enum:
          - au
          - eu
          - na
          - deputy
  /my/unavail/{unavailId}:
    put:
      tags:
      - Unavail
      summary: PUT Unavail / :unavailId
      operationId: my_unavail__unavailid_put
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Not authenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Not found
      parameters:
      - name: unavailId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
    delete:
      tags:
      - Unavail
      summary: DELETE Unavail / :unavailId
      operationId: my_unavail__unavailid_delete
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Not authenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Not found
      parameters:
      - name: unavailId
        in: path
        required: true
        schema:
          type: integer
          pattern: \d+
    servers:
    - url: https://{subdomain}.{region}.deputy.com/api/v1
      description: Deputy tenant
      variables:
        subdomain:
          default: your-subdomain
        region:
          default: deputy
          enum:
          - au
          - eu
          - na
          - deputy
  /supervise/unavail:
    servers:
    - url: https://{subdomain}.{region}.deputy.com/api/v1
      description: Deputy tenant
      variables:
        subdomain:
          default: your-subdomain
        region:
          default: deputy
          enum:
          - au
          - eu
          - na
          - deputy
    post:
      tags:
      - Unavail
      summary: Create or update Unavail
      operationId: supervise_unavail__post
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Not authenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Not found
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
  /supervise/unavail/{intEmployeeId}:
    servers:
    - url: https://{subdomain}.{region}.deputy.com/api/v1
      description: Deputy tenant
      variables:
        subdomain:
          default: your-subdomain
        region:
          default: deputy
          enum:
          - au
          - eu
          - na
          - deputy
    get:
      tags:
      - Unavail
      summary: GET Unavail / (:intEmployeeId)?
      operationId: supervise_unavail__intemployeeid__get
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Not authenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Not found
      parameters:
      - name: intEmployeeId
        in: path
        required: true
        schema:
          type: integer
          pattern: \d+
  /supervise/unavail/{unavailId}:
    servers:
    - url: https://{subdomain}.{region}.deputy.com/api/v1
      description: Deputy tenant
      variables:
        subdomain:
          default: your-subdomain
        region:
          default: deputy
          enum:
          - au
          - eu
          - na
          - deputy
    put:
      tags:
      - Unavail
      summary: PUT Unavail / :unavailId
      operationId: supervise_unavail__unavailid_put
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Not authenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Not found
      parameters:
      - name: unavailId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
    delete:
      tags:
      - Unavail
      summary: DELETE Unavail / :unavailId
      operationId: supervise_unavail__unavailid_delete
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Bad request
        '401':
          description: Not authenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Not found
      parameters:
      - name: unavailId
        in: path
        required: true
        schema:
          type: integer
          pattern: \d+
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 access token or Deputy Permanent Token.
x-refined-from:
- deputy-openapi.json
- deputy-unavail-api-openapi.yml