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

ResolveOnCallConflicts

Analyze conflicts and return prioritized resolution suggestions

POST/api/v1/oncall/conflicts/resolve

Operation ID

ResolveOnCallConflicts

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

Body Fields

  • conflicts
    ListRequired

    List of conflicts to resolve

    Example: (nested array)

    • type
      String

      Category of the detected conflict

      Example: overlap

    • userId
      String

      User ID involved in the conflict

      Example: user-abc123

    • userName
      String

      Display name of the user involved in the conflict

      Example: Alice Smith

    • details
      String

      Additional context about the conflict

      Example: Overlapping shifts on 2024-06-01

  • allSchedules
    ListRequired

    All schedules relevant to the conflict resolution analysis

    Example: (nested array)

    • 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

  • strategy
    StringRequired

    Resolution strategy to apply (e.g. auto, manual)

    Example: auto

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • totalConflicts
    Integer

    Total number of conflicts found during analysis

    Example: 3

  • suggestions
    List

    Ordered list of adjustment suggestions for resolving conflicts

    Example: (nested array)

    • 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

  • strategy
    String

    Resolution strategy used to generate suggestions

    Example: auto

  • generatedAt
    String

    Timestamp when this resolution result was generated

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