v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB

Release Templates

Adds a milestone to a release template.

Enterprise feature

Finds release template identified by its id and adds a milestone

post/api/admin/release-plan-templates/{templateId}/milestones

Path parameters

templateIdstring required

Response

#/components/schemas/releasePlanMilestoneSchema

idstring required

The milestone's ID. Milestone IDs are ulids.

namestring required

The name of the milestone.

sortOrderinteger required

The order of the milestone in the release plan.

releasePlanDefinitionIdstring required

The ID of the release plan/template that this milestone belongs to.

startedAtstring date-time nullable

The date and time when the milestone was started.

progressionExecutedAtstring date-time nullable

The date and time when the milestone progression was executed.

pausedAtstring date-time nullable

The date and time when the milestone was paused.

Example response

{
  "id": "01JB9GGTGQYEQ9D40R17T3YVW1",
  "name": "My milestone",
  "sortOrder": 1,
  "releasePlanDefinitionId": "01JB9GGTGQYEQ9D40R17T3YVW2",
  "startedAt": "2024-01-01T00:00:00.000Z",
  "transitionCondition": {
    "intervalMinutes": 30
  },
  "progressionExecutedAt": "2024-01-01T00:00:00.000Z",
  "pausedAt": "2024-01-01T00:00:00.000Z",
  "strategies": [
    {
      "id": "01JB9GGTGQYEQ9D40R17T3YVW3",
      "milestoneId": "01JB9GGTGQYEQ9D40R17T3YVW1",
      "sortOrder": 9999,
      "title": "Gradual Rollout 25-Prod",
      "name": "flexibleRollout",
      "strategyName": "flexibleRollout",
      "constraints": [
        {
          "values": [
            "1",
            "2"
          ],
          "inverted": false,
          "operator": "IN",
          "contextName": "appName",
          "caseInsensitive": false
        }
      ],
      "variants": [
        {
          "name": "blue_group",
          "weightType": "fix",
          "stickiness": "custom.context.field",
          "payload": {
            "type": "json",
            "value": "{\"color\": \"red\"}"
          }
        }
      ],
      "segments": [
        1,
        2
      ]
    }
  ]
}