Link a schedule to a release

A successful request to this endpoint links a run configuration to a release. This method returns the updated run configuration with the linked release.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Request

This request uses the POST method, which links a run configuration to a specified release by providing the release ID. A successful request returns the updated runConfiguration object with the linked release details.

For basic authorization, replace this with your API token in the header request in the Authorization: Bearer {your_api_token} format. The token must be valid and have sufficient permissions to modify run configurations.

The request data is provided as a JSON object.

You need to provide the following required parameters:

  • id (Path Parameter): The unique identifier of the run configuration you want to link to the release. This is included in the URL path.
  • releaseId (Request Body): A string that specifies the unique identifier of the release to link.

Response

A successful response returns the updated run configuration object, including the details of the linked release. The response is provided in JSON format.

{
  "id": 12345,
  "name": "Daily Smoke Test",
  "build": {
    "id": "67890",
    "name": "Build 1.2.3"
  },
  "status": "linked",
  "updatedAt": "2025-01-17T12:00:00Z"
}

Refer to the following table about the response body properties:

PropertyTypeDescription
idIntegerThe unique identifier of the run configuration.
nameStringThe name of the run configuration.
releaseObjectDetails of the linked release, including the release ID and name.
statusStringIndicates the linking status:
  • QUEUED
  • RUNNING
  • FAILED
  • SUCCESS
  • CANCELED
  • ERROR
  • WAIT_FOR_TRIGGER
  • EXPIRED
updatedAtStringThe timestamp when the run configuration was last updated in ISO 8601 format.

Try it!

  1. Provide the required parameters and values below (click the dropdown and plus icons):
  2. Select the language in Language.
  3. Enter your user name or API credentials.
  4. Review your API call and click Try it!
Path Params
int64
required
Query Params
int64
required
int64
required
Response

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*