List Revisions - Docs by LangChain

Path Parameters

deployment_id

string<uuid>

required

Query Parameters

limit

integer

default:20

Maximum number of resources to return.

Required range: 1 <= x <= 100

offset

integer

default:0

Pagination offset. Pass this value to subsequent requests to fetch the next page of resources.

Required range: x >= 0

status

string | null

Comma separated list of revision status (CREATING, QUEUED, AWAITING_BUILD, BUILDING, AWAITING_DEPLOY, DEPLOYING, CREATE_FAILED, BUILD_FAILED, DEPLOY_FAILED, DEPLOYED, SKIPPED, INTERRUPTED, UNKNOWN) fields to filter by.

remote_reconciled

boolean | null

Flag to filter by remote reconciled revisions.

Response

Successful Response

resources

Revision · object[]

required

Show child attributes

resources.id

string<uuid>

required

The ID of the revision.

This is a read-only field.

resources.created_at

string<date-time>

required

The creation time of the revision.

This is a read-only field.

resources.updated_at

string<date-time>

required

The last update time of the revision.

This is a read-only field.

resources.status

enum<string>

required

The status of the revision.

This is a read-only field.

Available options:

CREATING,

QUEUED,

AWAITING_BUILD,

BUILDING,

AWAITING_DEPLOY,

DEPLOYING,

CREATE_FAILED,

BUILD_FAILED,

DEPLOY_FAILED,

DEPLOYED,

SKIPPED,

INTERRUPTED,

UNKNOWN

resources.source

enum<string>

required

Deploy from a GitHub repository (github) or a Docker image (external_docker).

Deploying from GitHub is only available for Cloud SaaS deployments. Deploying from a Docker image is only available for self-hosted deployments. This cannot be changed once the deployment is created.

Available options:

github,

external_docker

resources.source_revision_config

SourceRevisionConfig · object

required

Source revision configuration.

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.

Show child attributes

resources.source_revision_config.repo_ref

string | null

The git ref of the repository used for the deployment.

Supports:
- Branches: Specify just the branch name (e.g., main, develop)
- Tags: Specify the full ref path (e.g., refs/tags/v1.0.0)

When using a tag, source_config.build_on_push must be set to false since tags are immutable.

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.

resources.source_revision_config.langgraph_config_path

string | null

The path to the LangGraph configuration file (langgraph.json) used for the deployment.

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.

resources.source_revision_config.image_uri

string | null

The URI of the Docker image used for the deployment.

When updating a deployment (PATCH), setting this field to a non-null value will trigger creation of a new revision. Only applicable for external_docker source.

resources.source_revision_config.repo_commit_sha

string | null

The commit SHA of the git repository used for the deployment.

This is a read-only field. Only applicable for github source.

offset

integer

required

Pagination offset. Pass this value to subsequent requests to fetch the next page.

LangSmith Deployment

Path Parameters

Query Parameters

Response