Get deployment
Retrieve information about a specific deployment by its ID.
Authorizations
Use a named environment API key. It starts with tr_dev_sk_, tr_prod_sk_, tr_stg_sk_, etc.
Create a named API key in the API Keys section of your Trigger.dev project dashboard. Choose the narrowest access preset that supports your integration.
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.
Path Parameters
The deployment ID.
Response
Successful request
The deployment ID
The current status of the deployment
PENDING, INSTALLING, BUILDING, DEPLOYING, DEPLOYED, FAILED, CANCELED, TIMED_OUT Hash of the deployment content
The short code for the deployment
The deployment version (e.g., "20250228.1")
Reference to the deployment image
Platform of the deployment image
The external deployment id this deployment was deployed under (--external-id), used by version skew protection to pin runs. Absent if the deployment was deployed without one
External build data if applicable
Error data if the deployment failed
Worker information if available

