> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tensorlake.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Suspend Sandbox

> Suspend a named running sandbox by snapshotting it and terminating the live container. Returns `202 Accepted` when suspension begins or is already in progress, and `200 OK` when the sandbox is already suspended.

Suspend a named running sandbox by snapshotting it and terminating the live container.

* This path accepts either the sandbox ID or the sandbox name.
* Only named sandboxes can be suspended. Ephemeral sandboxes return `400 Bad Request`.
* Tensorlake returns `202 Accepted` when suspension starts or is already in progress.
* Tensorlake returns `200 OK` when the sandbox is already suspended.


## OpenAPI

````yaml post /sandboxes/{sandbox_id}/suspend
openapi: 3.1.0
info:
  title: Tensorlake API
  description: >-
    Tensorlake Cloud APIs for Sandboxes, Document Ingestion, and Serverless
    Workflows
  license:
    name: ''
  version: 0.1.0
servers:
  - url: https://api.tensorlake.ai/
security:
  - bearerAuth: []
tags:
  - name: Tensorlake Cloud API
    description: >-
      Tensorlake Cloud APIs for Sandboxes, Document Ingestion, and Serverless
      Workflows
paths:
  /sandboxes/{sandbox_id}/suspend:
    parameters:
      - name: sandbox_id
        in: path
        description: The sandbox ID or sandbox name.
        required: true
        schema:
          type: string
    post:
      tags:
        - sandboxes
      summary: Suspend a sandbox
      description: >-
        Suspend a named running sandbox by snapshotting it and terminating the
        live container. Returns `202 Accepted` when suspension begins or is
        already in progress, and `200 OK` when the sandbox is already suspended.
      operationId: suspend_sandbox
      responses:
        '200':
          description: Sandbox was already suspended
        '202':
          description: Suspend initiated
        '400':
          description: >-
            Sandbox cannot be suspended in its current state, or the sandbox is
            ephemeral
          content:
            text/plain: {}
        '401':
          description: Unauthorized. Invalid or missing credentials
        '403':
          description: Forbidden. You do not have permission to access this resource
        '404':
          description: Sandbox not found
          content:
            text/plain: {}
        '500':
          description: Internal server error
          content:
            text/plain: {}
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````