On-Call Add positioned schedule policy target

content/en/api/v2/on-call/request.CreateOnCallEscalationPolicy.json

@@ -17,6 +17,15 @@
               "id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
               "type": "schedules"
             },
+            {
+              "config": {
+                "schedule": {
+                  "position": "previous"
+                }
+              },
+              "id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
+              "type": "schedules"
+            },
             {
               "id": "aeadc05e-98a8-11ec-ac2c-da7ad0900001",
               "type": "teams"

data/api/v2/full_spec.yaml

@@ -11226,6 +11226,76 @@ components:
       required:
       - type
       type: object
+    ConfiguredSchedule:
+      description: Full resource representation of a configured schedule target with
+        position (previous, current, or next).
+      properties:
+        attributes:
+          $ref: '#/components/schemas/ConfiguredScheduleTargetAttributes'
+        id:
+          description: Specifies the unique identifier of the configured schedule
+            target.
+          example: 00000000-aba1-0000-0000-000000000000_previous
+          type: string
+        relationships:
+          $ref: '#/components/schemas/ConfiguredScheduleTargetRelationships'
+        type:
+          $ref: '#/components/schemas/ConfiguredScheduleTargetType'
+      required:
+      - type
+      - id
+      - attributes
+      - relationships
+      type: object
+    ConfiguredScheduleTarget:
+      description: Relationship reference to a configured schedule target.
+      properties:
+        id:
+          description: Specifies the unique identifier of the configured schedule
+            target.
+          example: 00000000-aba1-0000-0000-000000000000_previous
+          type: string
+        type:
+          $ref: '#/components/schemas/ConfiguredScheduleTargetType'
+      required:
+      - type
+      - id
+      type: object
+    ConfiguredScheduleTargetAttributes:
+      description: Attributes for a configured schedule target, including position.
+      example:
+        position: previous
+      properties:
+        position:
+          $ref: '#/components/schemas/ScheduleTargetPosition'
+      required:
+      - position
+      type: object
+    ConfiguredScheduleTargetRelationships:
+      description: Represents the relationships of a configured schedule target.
+      properties:
+        schedule:
+          $ref: '#/components/schemas/ConfiguredScheduleTargetRelationshipsSchedule'
+      required:
+      - schedule
+      type: object
+    ConfiguredScheduleTargetRelationshipsSchedule:
+      description: Holds the schedule reference for a configured schedule target.
+      properties:
+        data:
+          $ref: '#/components/schemas/ScheduleTarget'
+      required:
+      - data
+      type: object
+    ConfiguredScheduleTargetType:
+      default: schedule_target
+      description: Indicates that the resource is of type `schedule_target`.
+      enum:
+      - schedule_target
+      example: schedule_target
+      type: string
+      x-enum-varnames:
+      - SCHEDULE_TARGET
     ConfluentAccountCreateRequest:
       description: Payload schema when adding a Confluent account.
       properties:
@@ -18735,13 +18805,24 @@ components:
                 type: users
               - id: 00000000-aba2-0000-0000-000000000000
                 type: schedules
+              - id: 00000000-aba2-0000-0000-000000000000_previous
+                type: schedule_target
               - id: 00000000-aba3-0000-0000-000000000000
                 type: teams
           type: steps
         - id: 00000000-aba1-0000-0000-000000000000
           type: users
         - id: 00000000-aba2-0000-0000-000000000000
           type: schedules
+        - attributes:
+            position: previous
+          id: 00000000-aba2-0000-0000-000000000000_previous
+          relationships:
+            schedule:
+              data:
+                id: 00000000-aba2-0000-0000-000000000000
+                type: schedules
+          type: schedule_target
         - id: 00000000-aba3-0000-0000-000000000000
           type: teams
       properties:
@@ -18769,7 +18850,10 @@ components:
               targets:
               - id: 00000000-aba1-0000-0000-000000000000
                 type: users
-              - id: 00000000-aba2-0000-0000-000000000000
+              - config:
+                  schedule:
+                    position: previous
+                id: 00000000-aba2-0000-0000-000000000000
                 type: schedules
               - id: 00000000-aba3-0000-0000-000000000000
                 type: teams
@@ -18813,6 +18897,7 @@ components:
         name:
           description: Specifies the name for the new escalation policy.
           example: On-Call Escalation Policy
+          minLength: 1
           type: string
         resolve_page_on_policy_end:
           description: Indicates whether the page is automatically resolved when the
@@ -18822,12 +18907,16 @@ components:
           description: Specifies how many times the escalation sequence is retried
             if there is no response.
           format: int64
+          maximum: 10
+          minimum: 0
           type: integer
         steps:
           description: A list of escalation steps, each defining assignment, escalation
             timeout, and targets for the new policy.
           items:
             $ref: '#/components/schemas/EscalationPolicyCreateRequestDataAttributesStepsItems'
+          maxItems: 10
+          minItems: 1
           type: array
       required:
       - name
@@ -18844,6 +18933,8 @@ components:
             step.
           example: 3600
           format: int64
+          maximum: 36000
+          minimum: 60
           type: integer
         targets:
           description: Specifies the collection of escalation targets for this step.
@@ -18895,6 +18986,7 @@ components:
         name:
           description: Specifies the name of the escalation policy.
           example: On-Call Escalation Policy
+          minLength: 1
           type: string
         resolve_page_on_policy_end:
           description: Indicates whether the page is automatically resolved when the
@@ -18904,6 +18996,8 @@ components:
           description: Specifies how many times the escalation sequence is retried
             if there is no response.
           format: int64
+          maximum: 10
+          minimum: 0
           type: integer
       required:
       - name
@@ -18966,10 +19060,11 @@ components:
       description: Represents included related resources when retrieving an escalation
         policy, such as teams, steps, or targets.
       oneOf:
-      - $ref: '#/components/schemas/TeamReference'
       - $ref: '#/components/schemas/EscalationPolicyStep'
       - $ref: '#/components/schemas/EscalationPolicyUser'
       - $ref: '#/components/schemas/ScheduleData'
+      - $ref: '#/components/schemas/ConfiguredSchedule'
+      - $ref: '#/components/schemas/TeamReference'
     EscalationPolicyStep:
       description: Represents a single step in an escalation policy, including its
         attributes, relationships, and resource type.
@@ -19017,15 +19112,29 @@ components:
       type: object
     EscalationPolicyStepTarget:
       description: Defines a single escalation target within a step for an escalation
-        policy creation request. Contains `id` and `type`.
+        policy creation request. Contains `id`, `type`, and optional `config`.
       properties:
+        config:
+          $ref: '#/components/schemas/EscalationPolicyStepTargetConfig'
         id:
           description: Specifies the unique identifier for this target.
           example: 00000000-aba1-0000-0000-000000000000
           type: string
         type:
           $ref: '#/components/schemas/EscalationPolicyStepTargetType'
       type: object
+    EscalationPolicyStepTargetConfig:
+      description: Configuration for an escalation target, such as schedule position.
+      properties:
+        schedule:
+          $ref: '#/components/schemas/EscalationPolicyStepTargetConfigSchedule'
+      type: object
+    EscalationPolicyStepTargetConfigSchedule:
+      description: Schedule-specific configuration for an escalation target.
+      properties:
+        position:
+          $ref: '#/components/schemas/ScheduleTargetPosition'
+      type: object
     EscalationPolicyStepTargetType:
       description: Specifies the type of escalation target (example `users`, `schedules`,
         or `teams`).
@@ -19106,6 +19215,7 @@ components:
         name:
           description: Specifies the name of the escalation policy.
           example: On-Call Escalation Policy
+          minLength: 1
           type: string
         resolve_page_on_policy_end:
           description: Indicates whether the page is automatically resolved when the
@@ -19115,12 +19225,16 @@ components:
           description: Specifies how many times the escalation sequence is retried
             if there is no response.
           format: int64
+          maximum: 10
+          minimum: 0
           type: integer
         steps:
           description: A list of escalation steps, each defining assignment, escalation
             timeout, and targets.
           items:
             $ref: '#/components/schemas/EscalationPolicyUpdateRequestDataAttributesStepsItems'
+          maxItems: 10
+          minItems: 1
           type: array
       required:
       - name
@@ -19138,6 +19252,8 @@ components:
             step.
           example: 3600
           format: int64
+          maximum: 36000
+          minimum: 60
           type: integer
         id:
           description: Specifies the unique identifier of this step.
@@ -19246,12 +19362,13 @@ components:
       x-enum-varnames:
       - USERS
     EscalationTarget:
-      description: Represents an escalation target, which can be a team, user, or
-        schedule.
+      description: Represents an escalation target, which can be a team, user, schedule,
+        or configured schedule target.
       oneOf:
       - $ref: '#/components/schemas/TeamTarget'
       - $ref: '#/components/schemas/UserTarget'
       - $ref: '#/components/schemas/ScheduleTarget'
+      - $ref: '#/components/schemas/ConfiguredScheduleTarget'
     EscalationTargets:
       description: A list of escalation targets for a step
       properties:
@@ -45350,7 +45467,8 @@ components:
       type: object
     ScheduleTarget:
       description: Represents a schedule target for an escalation policy step, including
-        its ID and resource type.
+        its ID and resource type. This is a shortcut for a configured schedule target
+        with position set to 'current'.
       properties:
         id:
           description: Specifies the unique identifier of the schedule resource.
@@ -45362,6 +45480,19 @@ components:
       - type
       - id
       type: object
+    ScheduleTargetPosition:
+      description: Specifies the position of a schedule target (example `previous`,
+        `current`, or `next`).
+      enum:
+      - previous
+      - current
+      - next
+      example: previous
+      type: string
+      x-enum-varnames:
+      - PREVIOUS
+      - CURRENT
+      - NEXT
     ScheduleTargetType:
       default: schedules
       description: Indicates that the resource is of type `schedules`.