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

GetOnCallResolutionHistory

Get the history of conflict resolutions applied to a schedule

GET/api/v1/oncall/schedules/{uuid}/resolution-history

Operation ID

GetOnCallResolutionHistory

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

Path Parameters

  • uuid
    StringRequired

    UUID of the schedule whose resolution history to retrieve

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • items
    List

    List of resolution records for the given schedule

    Example: (nested array)

    • uuid
      String

      Unique identifier of the resolution record

      Example: res-aabbccdd

    • scheduleUuid
      String

      UUID of the schedule this resolution was applied to

      Example: sched-00112233

    • conflictType
      String

      Type of conflict that was resolved

      Example: overlap

    • suggestion
      Object

      The adjustment suggestion that was applied

      • id
        String

        Unique identifier of this adjustment suggestion

        Example: sugg-11223344

      • type
        String

        Category type of the suggested adjustment

        Example: member_swap

      • description
        String

        Human-readable explanation of the proposed adjustment

        Example: Swap shifts between Alice and Bob to resolve overlap

      • targetConflicts
        List

        IDs of conflicts this suggestion addresses

        Example: item1,item2

      • changes
        List

        List of schedule changes included in this suggestion

        Example: (nested array)

        • scheduleUuid
          String

          UUID of the schedule being changed

          Example: sched-00112233

        • scheduleName
          String

          Name of the schedule being changed

          Example: Platform On-Call

        • changeType
          String

          Type of change applied to the schedule

          Example: member_swap

        • details
          LinkedHashMap

          Detailed information entries

          Example: (nested object)

        • before
          String

          Serialized state of the schedule before the change

          Example: user-abc123

        • after
          String

          Serialized state of the schedule after the change

          Example: user-xyz789

      • impact
        Object

        Impact assessment scores for this suggestion

        • fairnessScore
          Long

          Score reflecting fairness of shift distribution (0-1)

          Example: 0.85

        • coverageScore
          Long

          Score reflecting shift coverage completeness (0-1)

          Example: 0.92

        • minimalChangeScore
          Long

          Score reflecting how minimal the proposed changes are (0-1)

          Example: 0.78

        • overallScore
          Long

          Aggregate score combining all impact dimensions (0-1)

          Example: 0.85

      • priority
        Integer

        Priority ranking of this suggestion (lower is higher priority)

        Example: 1

    • appliedAt
      String

      Timestamp when the resolution was applied

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

    • appliedBy
      String

      User ID of the person who applied the resolution

      Example: user-admin01