Revisions

Create a revision

When you create a deployment, LangSmith creates its first revision. Use the LangSmith UI or LangGraph CLI to create subsequent revisions.

LangSmith UI
LangGraph CLI

From the LangSmith UI, select Deployments, then select a deployment.

In the top-right corner of the Deployment view, select + New Revision.
In the New Revision modal, specify the full path to the API configuration file, including the file name. For example, enter langgraph.json if the file is in the repository root.
Choose whether to make the deployment shareable through Studio.
Add, remove, or update environment variables and secrets. Existing values are prepopulated. For more information, see Environment variables.
Select Submit. LangSmith queues the revision for deployment.

Run langgraph deploy again from your project directory. The command finds the existing deployment by name and creates a revision with your latest code changes:

langgraph deploy

To target a deployment by ID, run:

langgraph deploy --deployment-id <DEPLOYMENT_ID>

To view deployment IDs, run:

langgraph deploy list

langgraph deploy can update only deployments originally created with langgraph deploy. Use the LangSmith UI to update deployments created through the UI or GitHub integration.

Interrupt a revision

Interrupt a revision only when it is stuck and prevents you from deploying another revision.

Interrupted revisions have undefined behavior. LangChain might remove this feature in the future.

To interrupt a revision:

From the Deployments view, select a deployment.

In the Revisions table, select the menu icon for the revision.

Select Interrupt.

Review the confirmation message, then select Interrupt revision.

Deployment guide

Reference

Create a revision

Interrupt a revision

See also

​Create a revision

​Interrupt a revision

​See also

Create a revision

Interrupt a revision

See also