Promote deployment

Promote a previously deployed version to be the current version for the environment. This makes the specified version active for new task runs.

POST /api/v1/deployments/{version}/promote

TypeScript

TypeScript

const response = await fetch(
  `https://api.trigger.dev/api/v1/deployments/${version}/promote`,
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${secretKey}`,
      "Content-Type": "application/json",
    },
  }
);
const result = await response.json();

200

{
  "id": "<string>",
  "version": "<string>",
  "shortCode": "<string>"
}

Authorizations

Authorization · string · header · required

Use your project-specific Secret API key. Will start with tr_dev_, tr_prod, tr_stg, etc.

You can find your Secret API key in the API Keys section of your Trigger.dev project dashboard.

Our TypeScript SDK will default to using the value of the TRIGGER_SECRET_KEY environment variable if it is set. If you are using the SDK in a different environment, you can set the key using the configure function.

import { configure } from "@trigger.dev/sdk";

configure({ accessToken: "tr_dev_1234" });

Path Parameters

version · string · required

The deployment version to promote (e.g., "20250228.1").

Response

200

application/json

Deployment promoted successfully

id · string

The deployment ID

version · string

The deployment version (e.g., "20250228.1")

shortCode · string

The short code for the deployment