Skip to content
Docs

Rolling Releases

Control how a new deployment receives production traffic for your project. You can start and advance a rolling release, update its settings, or roll back to a previous production deployment.

Update the active rolling release to the next stage for a project.

Parameters

ParameterTypeRequiredDescription
idOrNamestringYesProject ID or project name (URL-encoded)
teamIdstringNoTeam ID.
slugstringNoTeam slug.
requestBodyobjectNoRequest body for this tool.

Complete the rolling release for the project.

Parameters

ParameterTypeRequiredDescription
idOrNamestringYesProject ID or project name (URL-encoded)
teamIdstringNoTeam ID.
slugstringNoTeam slug.
requestBodyobjectNoRequest body for this tool.

Get the active rolling release information for a project.

Parameters

ParameterTypeRequiredDescription
idOrNamestringYesProject ID or project name (URL-encoded)
statestringNoFilter by rolling release state Allowed values: "ACTIVE", "COMPLETE", "ABORTED".
teamIdstringNoTeam ID.
slugstringNoTeam slug.

Get rolling release billing status.

Parameters

ParameterTypeRequiredDescription
idOrNamestringYesProject ID or project name (URL-encoded)
teamIdstringNoTeam ID.
slugstringNoTeam slug.

Get rolling release configuration.

Parameters

ParameterTypeRequiredDescription
idOrNamestringYesProject ID or project name (URL-encoded)
teamIdstringNoTeam ID.
slugstringNoTeam slug.

Gets a list of aliases with status for the current promote.

Parameters

ParameterTypeRequiredDescription
projectIdstringYesThe project ID.
limitnumberNoMaximum number of aliases to list from a request (max 100).
sincenumberNoGet aliases created after this epoch timestamp.
untilnumberNoGet aliases created before this epoch timestamp.
failedOnlybooleanNoFilter results down to aliases that failed to map to the requested deployment
teamIdstringNoTeam ID.
slugstringNoTeam slug.

Point production traffic to a given deployment.

Parameters

ParameterTypeRequiredDescription
projectIdstringYesThe project ID.
deploymentIdstringYesThe deployment ID.
teamIdstringNoTeam ID.
slugstringNoTeam slug.
requestBodyunknownNoRequest body for this tool.

Point production traffic to a previous production deployment by ID.

Parameters

ParameterTypeRequiredDescription
projectIdstringYesThe project ID.
deploymentIdstringYesThe ID of the deployment to rollback to
descriptionstringNoThe reason for the rollback
teamIdstringNoTeam ID.
slugstringNoTeam slug.
requestBodyunknownNoRequest body for this tool.

Start a rolling release for the project.

Parameters

ParameterTypeRequiredDescription
idOrNamestringYesProject ID or project name (URL-encoded)
teamIdstringNoTeam ID.
slugstringNoTeam slug.
requestBodyobjectNoRequest body for this tool.

Update the rolling release settings for the project.

Parameters

ParameterTypeRequiredDescription
idOrNamestringYesProject ID or project name (URL-encoded)
teamIdstringNoTeam ID.
slugstringNoTeam slug.
requestBodyunknownNoRequest body for this tool.

Was this helpful?

supported.