Skip to main content
ZStack
Alerting & Response/On-Call

UpdateOnCallSchedule

Update an existing on-call schedule's configuration or members

PUT/api/v1/oncall/schedules/{uuid}

Operation ID

UpdateOnCallSchedule

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Path Parameters

  • uuid
    StringRequired

    UUID of the schedule to update

Body Fields

  • name
    StringRequired

    Updated name for the schedule

    Example: my-resource

  • description
    StringRequired

    Updated description for the schedule

    Example: A brief description

  • timezone
    StringRequired

    Updated IANA timezone name

    Example: value

  • shiftDuration
    StringRequired

    Updated shift duration as a Go duration string

    Example: value

  • members
    ListRequired

    Updated ordered list of members for the rotation

    Example: (nested array)

    • userId
      String

      User identifier of the on-call member

      Example: user-abc123

    • userName
      String

      Display name of the on-call member

      Example: Alice Smith

    • order
      Integer

      Rotation order position of the member within the schedule

      Example: 1

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Unique identifier of the schedule

    Example: sched-00112233

  • name
    String

    Human-readable name of the schedule

    Example: Platform On-Call

  • description
    String

    Brief description of the schedule purpose

    Example: 24x7 platform on-call rotation

  • timezone
    String

    IANA timezone name for the schedule

    Example: Asia/Shanghai

  • rotationType
    String

    Rotation type: daily, weekly, or custom

    Example: weekly

  • shiftDuration
    String

    Duration of each shift as a Go duration string

    Example: 168h

  • members
    List

    Ordered list of members participating in the rotation

    Example: (nested array)

    • userId
      String

      User identifier of the on-call member

      Example: user-abc123

    • userName
      String

      Display name of the on-call member

      Example: Alice Smith

    • order
      Integer

      Rotation order position of the member within the schedule

      Example: 1

  • startDate
    String

    Timestamp when the schedule rotation begins

    Example: 2026-01-15T08:00:00Z

  • createDate
    String

    Timestamp when the schedule was created

    Example: 2026-01-15T08:00:00Z

  • lastOpDate
    String

    Timestamp of the last modification to the schedule

    Example: 2026-01-15T08:00:00Z