Skip to content

chore(docs): remove sandbox templates, pools, and volumes#3648

Open
Daniel Kneipp (DanielKneipp) wants to merge 6 commits intomainfrom
daniel/sandbox-docs-cleanup
Open

chore(docs): remove sandbox templates, pools, and volumes#3648
Daniel Kneipp (DanielKneipp) wants to merge 6 commits intomainfrom
daniel/sandbox-docs-cleanup

Conversation

@DanielKneipp
Copy link
Copy Markdown
Contributor

@DanielKneipp Daniel Kneipp (DanielKneipp) commented Apr 21, 2026

Overview

Mirrors the SDK-side deprecation of sandbox templates, warm pools, and volumes for the public docs. Sandboxes now boot directly from snapshots; there are no templates or pools left in the public API surface.

  • Deletes langsmith/sandbox-templates and langsmith/sandbox-warm-pools plus their screenshots.
  • Adds langsmith/sandbox-snapshots covering build-from-Docker, capture-from-sandbox, CRUD, and stop/start flows with Python + TypeScript <CodeGroup> examples.
  • Rewrites sandboxes.mdx, sandbox-sdk.mdx, sandbox-service-urls.mdx, and sandbox-auth-proxy.mdx so every example uses snapshot_id (Python) / positional snapshotId (TypeScript). Removes every create_template / createTemplate call.
  • Updates the Sandboxes nav group in docs.json: Overview → Snapshots → Service URLs → Auth proxy → SDK usage.

Type of change

Type: Remove outdated content

Related issues/PRs

Checklist

  • I have read the contributing guidelines, including the language policy
  • I have tested my changes locally using docs dev
  • All code examples have been tested and work correctly
  • I have used root relative paths for internal links
  • I have updated navigation in src/docs.json if needed

Additional notes

oss/deepagents/* docs still reference template_name because the deepagents CLI/package still uses templates. Deepagents owns its own migration; one dangling link to /langsmith/sandbox-templates remains in oss/deepagents/frontend/sandbox.mdx until they update.

Mirror the SDK-side deprecation (#2757 Python, #2758 JS): sandboxes now
boot directly from snapshots, so the template and warm-pool pages are
gone and every remaining example uses snapshot_id / positional
snapshotId. Adds a dedicated Snapshots page covering build / capture /
CRUD / stop-start flows, rewires the Sandboxes nav, and drops the
associated screenshots.

Made-with: Cursor
@github-actions github-actions Bot added langsmith For docs changes to LangSmith internal labels Apr 21, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 21, 2026

❌ docs.json validation failed

This PR has issues with docs.json: either pages were removed without redirects, or some pages reference non-existent source files.

 The following pages were removed from docs.json without adding redirects:
  - langsmith/sandbox-templates
  - langsmith/sandbox-warm-pools

Please add a redirect for each removed page to the `redirects` array in docs.json.
Example: {"source": "/path/to/removed-page", "destination": "/path/to/new-location"}

…point kwarg

- Document source_sandbox_id on captured snapshots and show reading back a
  file from /opt after capture, covering the "install packages / prep data /
  capture" flow end to end.
- Add a Note clarifying that capture preserves the persistent filesystem only
  (installed packages and files under /usr/local, /root, /opt, home, etc.),
  and that /tmp (tmpfs), running processes, and in-memory state are not kept.
- Add missing `import os` to the create_snapshot Python example.
- Drop the `checkpoint` kwarg example — the SDK exposes no way to produce a
  valid checkpoint name, so users cannot actually use it today.

Made-with: Cursor
@DanielKneipp Daniel Kneipp (DanielKneipp) marked this pull request as ready for review April 21, 2026 14:18
@github-actions
Copy link
Copy Markdown
Contributor

Thanks for opening a docs PR, Daniel Kneipp (@DanielKneipp)! When it's ready for review, please add the relevant reviewers:

  • @katmayb or @fjmorris (LangSmith)

- Mention that create_sandbox / createSandbox accepts a snapshot by ID
  or by name, with a short example in the capture section.
- Document that list_snapshots / listSnapshots paginates server-side
  (default 50, max 500) and accepts name_contains / limit / offset
  filters.
@github-actions
Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-daniel-1776850929-9d0071d

Site preview: https://langchain-5e9cc07a-preview-daniel-1776850929-9d0071d.mintlify.app

Changed documentation pages (preview deep links):

Only the top 5 changed markdown files by diff size are listed.

@github-actions github-actions Bot added deepagents For docs changes to Deep Agents oss labels Apr 22, 2026
Fixes two LangChain.DashesSpaces Vale errors flagged by the
lint-prose CI workflow.

Made-with: Cursor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

deepagents For docs changes to Deep Agents internal langsmith For docs changes to LangSmith oss

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants