Skip to main content
A revision deploys a version of your application to an existing Agent Server on LangSmith Cloud. Create a revision to release code changes without creating another Agent Server.

Create a revision

When you create an Agent Server, LangSmith creates its first revision. Use the LangSmith UI or LangGraph CLI to create subsequent revisions.
From the LangSmith UI, select Agent Servers, then select an Agent Server.
  1. In the top-right corner of the Agent Server view, select + New Revision.
  2. 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.
  3. Choose whether to make the Agent Server shareable through Studio.
  4. Add, remove, or update environment variables and secrets. Existing values are prepopulated. For more information, see Environment variables.
  5. Select Submit. LangSmith queues the revision for deployment.

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:
  1. From the Agent Servers view, select an Agent Server.
  2. In the Revisions table, select the menu icon for the revision.
  3. Select Interrupt.
  4. Review the confirmation message, then select Interrupt revision.

See also