Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  4. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  5. Incidents
    1. Get started
    2. Advanced guide
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Integrations
    1. Integrating with Better Stack
  8. Team and account management
    1. Team management
    2. Account settings
    3. Audit logs
    4. Migrating to pay as you go
  9. Uptime API
    1. Get an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
      1. On-call calendar
        1. List on-call calendars GET
        2. Get on-call calendar GET
        3. Create on-call calendar POST
        4. Update on-call calendar PATCH
        5. Remove on-call calendar DELETE
        6. Response attributes
      2. On-call calendar events
      3. On-call calendar rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
      9. Comments
    5. Status pages
    6. Metadata
    7. Integrations

Remove on-call calendar

Permanently deletes an existing on-call calendar.

DELETE https://uptime.betterstack.com/api/v2/on-calls/{calendar_id}

URL parameters

calendar_id
required string

The ID of the calendar you want to delete

Headers

Authorization
required string

Bearer $TOKEN

204

Returns empty body

Example cURL

Example
curl --request DELETE \
  --url https://uptime.betterstack.com/api/v2/on-calls/56 \
  --header "Authorization: Bearer $TOKEN"

Previous article

Update an on-call calendar

Next article

Response attributes