Cal.com Out of Office API
The Out of Office API from Cal.com — 2 operation(s) for out of office.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cal-com:cal-com-out-of-office-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Cal.com API v2 Out of Office API
description: ''
version: 1.0.0
contact: {}
servers: []
tags:
- name: Out of Office
paths:
/v2/me/ooo:
get:
description: If accessed using an OAuth access token, the `SCHEDULE_READ` scope is required.
operationId: UserOOOController_getMyOOO
parameters:
- name: Authorization
in: header
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_, managed user access token, or OAuth access token
required: true
schema:
type: string
- name: take
required: false
in: query
description: Maximum number of items to return
schema:
minimum: 1
maximum: 250
default: 250
example: 25
type: number
- name: skip
required: false
in: query
description: Number of items to skip
schema:
minimum: 0
default: 0
example: 0
type: number
- name: sortStart
required: false
in: query
description: Sort results by their start time in ascending or descending order.
schema:
example: ?sortStart=asc OR ?sortStart=desc
type: string
enum:
- asc
- desc
- name: sortEnd
required: false
in: query
description: Sort results by their end time in ascending or descending order.
schema:
example: ?sortEnd=asc OR ?sortEnd=desc
type: string
enum:
- asc
- desc
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/UserOoosOutputResponseDto'
summary: Get all out-of-office entries for the authenticated user
tags:
- Out of Office
x-oauth-scopes:
- SCHEDULE_READ
post:
description: If accessed using an OAuth access token, the `SCHEDULE_WRITE` scope is required.
operationId: UserOOOController_createMyOOO
parameters:
- name: Authorization
in: header
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_, managed user access token, or OAuth access token
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateOutOfOfficeEntryDto'
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/UserOooOutputResponseDto'
summary: Create an out-of-office entry for the authenticated user
tags:
- Out of Office
x-oauth-scopes:
- SCHEDULE_WRITE
/v2/me/ooo/{oooId}:
patch:
description: If accessed using an OAuth access token, the `SCHEDULE_WRITE` scope is required.
operationId: UserOOOController_updateMyOOO
parameters:
- name: Authorization
in: header
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_, managed user access token, or OAuth access token
required: true
schema:
type: string
- name: oooId
required: true
in: path
schema:
type: number
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateOutOfOfficeEntryDto'
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/UserOooOutputResponseDto'
summary: Update an out-of-office entry for the authenticated user
tags:
- Out of Office
x-oauth-scopes:
- SCHEDULE_WRITE
delete:
description: If accessed using an OAuth access token, the `SCHEDULE_WRITE` scope is required.
operationId: UserOOOController_deleteMyOOO
parameters:
- name: Authorization
in: header
description: value must be `Bearer <token>` where `<token>` is api key prefixed with cal_, managed user access token, or OAuth access token
required: true
schema:
type: string
- name: oooId
required: true
in: path
schema:
type: number
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/UserOooOutputResponseDto'
summary: Delete an out-of-office entry for the authenticated user
tags:
- Out of Office
x-oauth-scopes:
- SCHEDULE_WRITE
components:
schemas:
UserOoosOutputResponseDto:
type: object
properties:
status:
enum:
- success
- error
type: string
example: success
data:
type: array
items:
$ref: '#/components/schemas/UserOooOutputDto'
required:
- status
- data
UserOooOutputResponseDto:
type: object
properties:
status:
enum:
- success
- error
type: string
example: success
data:
$ref: '#/components/schemas/UserOooOutputDto'
required:
- status
- data
CreateOutOfOfficeEntryDto:
type: object
properties:
start:
format: date-time
type: string
description: The start date and time of the out of office period in ISO 8601 format in UTC timezone.
example: '2023-05-01T00:00:00.000Z'
end:
format: date-time
type: string
description: The end date and time of the out of office period in ISO 8601 format in UTC timezone.
example: '2023-05-10T23:59:59.999Z'
notes:
type: string
description: Optional notes for the out of office entry.
example: Vacation in Hawaii
toUserId:
type: number
description: The ID of the user covering for the out of office period, if applicable.
example: 2
reason:
enum:
- unspecified
- vacation
- travel
- sick
- public_holiday
type: string
description: the reason for the out of office entry, if applicable
example: vacation
required:
- start
- end
UserOooOutputDto:
type: object
properties:
userId:
type: number
description: The ID of the user.
example: 2
toUserId:
type: number
description: The ID of the user covering for the out of office period, if applicable.
example: 2
id:
type: number
description: The ID of the ooo entry.
example: 2
uuid:
type: string
description: The UUID of the ooo entry.
example: e84be5a3-4696-49e3-acc7-b2f3999c3b94
start:
format: date-time
type: string
description: The start date and time of the out of office period in ISO 8601 format in UTC timezone.
example: '2023-05-01T00:00:00.000Z'
end:
format: date-time
type: string
description: The end date and time of the out of office period in ISO 8601 format in UTC timezone.
example: '2023-05-10T23:59:59.999Z'
notes:
type: string
description: Optional notes for the out of office entry.
example: Vacation in Hawaii
reason:
enum:
- unspecified
- vacation
- travel
- sick
- public_holiday
type: string
description: the reason for the out of office entry, if applicable
example: vacation
required:
- userId
- id
- uuid
- start
- end
UpdateOutOfOfficeEntryDto:
type: object
properties:
start:
format: date-time
type: string
description: The start date and time of the out of office period in ISO 8601 format in UTC timezone.
example: '2023-05-01T00:00:00.000Z'
end:
format: date-time
type: string
description: The end date and time of the out of office period in ISO 8601 format in UTC timezone.
example: '2023-05-10T23:59:59.999Z'
notes:
type: string
description: Optional notes for the out of office entry.
example: Vacation in Hawaii
toUserId:
type: number
description: The ID of the user covering for the out of office period, if applicable.
example: 2
reason:
enum:
- unspecified
- vacation
- travel
- sick
- public_holiday
type: string
description: the reason for the out of office entry, if applicable
example: vacation
x-provenance:
method: harvested
publisher: Cal.com
source: https://cal.com/docs/api-reference/v2/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)