Release Candidate — the API is undergoing final validation before general availability, and minor changes may still occur.
Hellomateo API Documentation
DocumentationAPI Reference
Calendars

Delete Calendar

DELETE
/v1/calendars/{id}

Deletes the specified calendar.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Unique identifier for the resource.

Formatuuid

Response Body

curl -X DELETE "https://api.getmateo.com/v1/calendars/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty

Delete Calendar by Locator DELETE

Deletes the calendar resolved by exactly one of id or external_id within this organisation. A repeated DELETE may return 404 after the first success.

Get Calendar Blocked Time by External ID GET

Resolves an immutable, case-sensitive external_id within this organisation and returns the blocked time. Use this endpoint to recover after an ambiguous create timeout before deciding whether to retry POST. Recurring masters and exceptions have distinct external_id values; the master response id is the Mateo UUID used as an exception series_id.