Attrove Calendars API
The Calendars API from Attrove — 2 operation(s) for calendars.
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/attrove-com:attrove-com-calendars-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: Attrove Calendars API
description: Attrove public API, partner, and A2A endpoints
version: v1
servers:
- url: http://0.0.0.0:3000
tags:
- name: Calendars
paths:
/v1/users/{user_id}/calendars:
get:
summary: List user calendars
tags:
- Calendars
description: 'Returns all calendars discovered for a user''s calendar integrations.
**Filtering:**
- `integration_id`: Filter to a specific integration (int_xxx format)
- `active`: Filter by active status (true/false)
**Expand parameter**:
By default, `description` is not included.
Use `expand=description` to include calendar descriptions.
**Pagination:**
- `limit`: Maximum number of calendars to return (default: 100, max: 100)
- `offset`: Number of calendars to skip for pagination (default: 0)
**Note:** By default, only the primary calendar is active. Use PATCH to activate additional calendars.'
parameters:
- schema:
type: string
in: query
name: integration_id
required: false
description: Filter to a specific integration (int_xxx format)
- schema:
type: string
enum:
- 'true'
- 'false'
in: query
name: active
required: false
description: Filter by active status
- schema:
type: string
pattern: ^[0-9]+$
in: query
name: limit
required: false
description: Number of items to return (1-100, default 50)
- schema:
type: string
pattern: ^[0-9]+$
in: query
name: offset
required: false
description: Number of items to skip (default 0)
- schema:
type: string
in: query
name: expand
required: false
description: 'Comma-separated list of fields to include. Valid options: description'
- schema:
type: string
format: uuid
in: path
name: user_id
required: true
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
error:
type: object
properties:
code:
type: string
message:
type: string
details: {}
required:
- code
- message
data:
type: array
items:
type: object
additionalProperties: false
properties:
id:
type: string
description: Opaque calendar ID (cal_xxx format)
integration_id:
type: string
description: Opaque integration ID (int_xxx format)
title:
type: string
nullable: true
description: Calendar display name
description:
type: string
nullable: true
description: Calendar description
active:
type: boolean
description: Whether this calendar is being synced
created_at:
type: string
format: date-time
description: When the calendar was discovered
updated_at:
type: string
format: date-time
nullable: true
description: When the calendar was last modified
required:
- id
- integration_id
- active
- created_at
pagination:
type: object
properties:
limit:
type: number
offset:
type: number
has_more:
type: boolean
total_count:
type: number
required:
- limit
- offset
- has_more
required:
- success
- data
- pagination
'400':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
'401':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
'500':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
operationId: getV1UsersByUserIdCalendars
x-operation-id-source: derived
/v1/users/{user_id}/calendars/{id}:
get:
summary: Get calendar by ID
tags:
- Calendars
description: Returns a single calendar by its ID. Accepts cal_xxx opaque ID format.
parameters:
- schema:
type: string
format: uuid
in: path
name: user_id
required: true
- schema:
type: string
in: path
name: id
required: true
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
error:
type: object
properties:
code:
type: string
message:
type: string
details: {}
required:
- code
- message
data:
type: object
additionalProperties: false
properties:
id:
type: string
description: Opaque calendar ID (cal_xxx format)
integration_id:
type: string
description: Opaque integration ID (int_xxx format)
title:
type: string
nullable: true
description: Calendar display name
description:
type: string
nullable: true
description: Calendar description
active:
type: boolean
description: Whether this calendar is being synced
created_at:
type: string
format: date-time
description: When the calendar was discovered
updated_at:
type: string
format: date-time
nullable: true
description: When the calendar was last modified
required:
- id
- integration_id
- active
- created_at
required:
- success
- data
'400':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
'401':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
'404':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
'500':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
operationId: getV1UsersByUserIdCalendarsById
x-operation-id-source: derived
patch:
summary: Update calendar
tags:
- Calendars
description: 'Updates a calendar''s properties. Accepts cal_xxx opaque ID format.
**Supported updates:**
- `active`: Enable/disable syncing for this calendar
When a calendar is activated, its events will begin syncing on the next sync cycle (within 5 minutes).'
requestBody:
content:
application/json:
schema:
type: object
properties:
active:
type: boolean
parameters:
- schema:
type: string
format: uuid
in: path
name: user_id
required: true
- schema:
type: string
in: path
name: id
required: true
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
error:
type: object
properties:
code:
type: string
message:
type: string
details: {}
required:
- code
- message
data:
type: object
additionalProperties: false
properties:
id:
type: string
description: Opaque calendar ID (cal_xxx format)
integration_id:
type: string
description: Opaque integration ID (int_xxx format)
title:
type: string
nullable: true
description: Calendar display name
description:
type: string
nullable: true
description: Calendar description
active:
type: boolean
description: Whether this calendar is being synced
created_at:
type: string
format: date-time
description: When the calendar was discovered
updated_at:
type: string
format: date-time
nullable: true
description: When the calendar was last modified
required:
- id
- integration_id
- active
- created_at
required:
- success
- data
'400':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
'401':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
'404':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
'500':
description: Default Response
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
success:
type: boolean
enum:
- false
error:
type: object
additionalProperties: false
properties:
code:
type: string
description: Machine-readable error code (e.g., AUTH_INVALID_TOKEN, RESOURCE_NOT_FOUND)
message:
type: string
description: Human-readable error message
details:
description: Optional additional error context
required:
- code
- message
required:
- success
- error
operationId: patchV1UsersByUserIdCalendarsById
x-operation-id-source: derived