Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Advanced guide
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
      1. On-call schedule
        1. List on-call schedules GET
        2. Get on-call schedule GET
        3. Create on-call schedule POST
        4. Update on-call schedule PATCH
        5. Remove on-call schedule DELETE
        6. Response attributes
      2. On-call schedule events
      3. On-call schedule 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 schedule

Permanently deletes an existing on-call schedule.

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

URL parameters

schedule_id
required string

The ID of the schedule 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 schedule

Next article

Response attributes