Skip to content
Skip to main content
DELETE
https://api.us.nylas.com/v3/grants/{grant_id}/calendars/{calendar_id}

Delete a calendar

Deletes the specified calendar. You cannot delete the primary calendar associated with an account ("is_primary": true).

NYLAS API KEYACCESS TOKEN

Parameters

Path parameters

grant_id*string

ID of the grant to access. Use /me/ to refer to the grant associated with an access token.

calendar_id*string

ID of the calendar to access. You can use primary to refer to the primary calendar associated with a grant. Nylas recommends you URL-encode this field, or you might receive a 404 error if the ID contains special characters (for example, #).

For an Agent Account, the GET and PUT requests also accept the account's own email address, in any letter case, to reach its primary calendar. DELETE takes the calendar's real ID only.

Responses

request_id*string

ID of the request.

Example: "5967ca40-a2d8-4ee0-a0e0-6f18ace39a90"
DELETEhttps://api.us.nylas.com/v3/grants/{grant_id}/calendars/{calendar_id}

Find your API key in the Nylas Dashboard under API Keys in your application settings.

grant_idrequiredstring

ID of the grant to access. Use /me/ to refer to the grant associated with an access token.

calendar_idrequiredstring

ID of the calendar to access. You can use primary to refer to the primary calendar associated with a grant. Nylas recommends you URL-encode this field, or you might receive a `404` error if the ID contains special characters (for example, #). For an Agent Account, the GET and PUT requests also accept the account's own email address, in any letter case, to reach its primary calendar. DELETE takes the calendar's real ID only.