---
title: "Get Revision"
method: GET
path: "/v2/deployments/{deployment_id}/revisions/{revision_id}"
tags: ["Deployments (v2)"]
---

# Get Revision

`GET /v2/deployments/{deployment_id}/revisions/{revision_id}`

Get a revision by ID for a deployment.

## Path parameters

- `deployment_id` string, uuid, required
- `revision_id` string, uuid, required

## Response `200`

Successful Response

- Revision — Revision resource.
  - `id` string, uuid, required — The ID of the revision.<br><br>This is a read-only field.
  - `created_at` string, date-time, required — The creation time of the revision.<br><br>This is a read-only field.
  - `updated_at` string, date-time, required — The last update time of the revision.<br><br>This is a read-only field.
  - `status` 'CREATING' | 'QUEUED' | 'AWAITING_BUILD' | 'BUILDING' | 'AWAITING_DEPLOY' | 'DEPLOYING' | 'CREATE_FAILED' | 'BUILD_FAILED' | 'DEPLOY_FAILED' | 'DEPLOYED' | 'SKIPPED' | 'INTERRUPTED' | 'UNKNOWN', required — The status of the revision.<br><br>This is a read-only field.
  - `source` 'github' | 'external_docker' | 'internal_docker' | 'internal_source' | 'internal_template', required — Deploy from a GitHub repository (`github`), an external Docker image (`external_docker`), a CLI-pushed image (`internal_docker`), uploaded source (`internal_source`), or a prebuilt LangChain template (`internal_template`).<br><br>Deploying from GitHub, internal Docker, internal source, or a template is only available for Cloud SaaS deployments. Deploying from an external Docker image is only available for self-hosted deployments. This cannot be changed once the deployment is created.
  - `source_revision_config` SourceRevisionConfig, required — Source revision configuration.<br> <br> For a `Deployment` resource, the field values refer to the latest revision of the `Deployment`. For a `Revision` resource, the field values refer to the `Revision` itself.
    - `repo_ref` string, nullable — The git ref of the repository used for the deployment.<br><br>Supports:<br>- **Branches**: Specify just the branch name (e.g., `main`, `develop`)<br>- **Tags**: Specify the full ref path (e.g., `refs/tags/v1.0.0`)<br><br>When using a tag, `source_config.build_on_push` must be set to `false` since tags are immutable.<br><br>When updating a deployment (`PATCH`), setting this field to a non-null value will trigger creation of a new revision. Only applicable for `github` source.
    - `langgraph_config_path` string, nullable — The path to the LangGraph configuration file (`langgraph.json`) used for the deployment.<br><br>Required on create for buildable sources (`github`, `internal_source`). Must be `null` for all other sources.<br><br>When updating a deployment (`PATCH`), setting this field to a non-null value will trigger creation of a new revision.
    - `image_uri` string, nullable — The URI of the Docker image used for the deployment.<br><br>When updating a deployment (`PATCH`), setting this field to a non-null value will trigger creation of a new revision. Applicable for `external_docker` source.
    - `source_tarball_path` string, nullable — The object path of the uploaded source tarball.<br><br>Must be an object path obtained from the `POST /deployments/{deployment_id}/upload-url` endpoint. Arbitrary paths are not accepted.<br><br>When updating a deployment (`PATCH`), setting this field to a non-null value will trigger creation of a new revision. Only applicable for `internal_source` source.
    - `repo_commit_sha` string, nullable — The commit SHA of the git repository used for the deployment.<br><br>This is a read-only field. Only applicable for `github` source.

## Other responses

- `404` — Not Found
- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith-deployment-control-plane-api.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith-deployment-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith-deployment-control-plane-api/versions/a0cd098699b4/schema)