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
      2. On-call schedule events
        1. List on-call schedule events GET
        2. Get on-call schedule event GET
        3. Create on-call schedule event POST
        4. Update on-call schedule event PATCH
        5. Remove on-call schedule event DELETE
        6. Bulk update on-call schedule events PUT
        7. Response attributes
      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

Update on-call schedule event

Update a single event in the given on-call schedule.

Events starting sooner than today at 0:00 UTC can't be updated.

PATCH https://uptime.betterstack.com/api/v2/on-calls/{schedule_id}/events/{event_id}

URL parameters

schedule_id
required string

The ID of the on-call schedule that the event is part of. Use default to refer to the default on-call schedule for the team.

event_id
required string

The ID of the event you want to update.

Headers

Authorization
required string

Bearer $TOKEN

Body parameters

starts_at
date

Start time of the event. Must be today at 0:00 UTC or later.

ends_at
date

End time of the event.

users
array

List of email addresses of the users that will be on-call during this event.

200

Event was updated

Response body

{
  "id": 12345678,
  "starts_at": "2025-01-01T09:45:00Z",
  "ends_at": "2025-01-01T17:00:00",
  "users": [
    "tomas@betterstack.com"
  ]
}
422

Event was not updated

Response body

{
  "errors": {
    "base": [
      "events ending before today at 00:00 UTC can't be updated or deleted"
    ]
  }
}

Example cURL

Example
curl --request PATCH \
  --url "https://uptime.betterstack.com/api/v2/on-calls/default/events/12345678" \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{ "starts_at": "2025-01-01T09:45:00Z" }'

Previous article

Create an on-call schedule event

Next article

Remove on-call schedule event