---
title: "Retrieve a deployment"
method: GET
path: "/compute/{connection_id}/deployment/{id}"
tags: ["compute", "deployment"]
---

# Retrieve a deployment

`GET /compute/{connection_id}/deployment/{id}`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/compute/{connection_id}/deployment/{id}`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required
- `id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Response `200`

Successful

- ComputeDeployment
  - `id` string: Unique identifier for the deployment
  - `created_at` string, date-time: When the deployment was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: When the deployment was last updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `service_id` string: The service this deployment belongs to
  - `status` 'QUEUED' | 'BUILDING' | 'DEPLOYING' | 'LIVE' | 'FAILED' | 'CANCELED' | 'SUPERSEDED' | 'OTHER': Normalized deployment status; set to CANCELED on update to cancel
  - `trigger` 'GIT' | 'MANUAL' | 'API' | 'ROLLBACK' | 'OTHER': What started the deployment
  - `environment` 'PRODUCTION' | 'PREVIEW' | 'DEVELOPMENT' | 'OTHER': Target environment
  - `commit_identifier` string: Source commit SHA (reference to RepoCommit)
  - `commit_message` string: Source commit message
  - `branch` string: Source branch
  - `image` string: Container image deployed, for image-based services
  - `url` string: URL where this deployment is served
  - `started_at` string, date-time: When the build started (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `finished_at` string, date-time: When the deployment finished (live, failed or canceled) (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `error` string: Failure description
  - `metadata` ComputeMetadata[]: Vendor labels, tags and metadata
    - `id` string: The label, tag or metadata identifier
    - `slug` string: The label, tag or metadata key
    - `value` unknown
    - `namespace` string: The origin of the value (eg. labels, tags, metadata)
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'ARRAY' | 'OBJECT': The data type of the value
    - `extra_data` unknown
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)