> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.astropods.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.astropods.com/_mcp/server.

# Open a terminal on your dev session's sandbox

GET /api/v1/accounts/{account}/dev-sessions/{agent}/sandboxes/{name}/terminal

Opens an interactive shell in a sandbox that your own dev session for the agent holds. The protocol matches the deployment terminal. A request with no Origin header is refused, so send the server's own URL as Origin.

Reference: https://docs.astropods.com/api-reference/astropods-api/sandboxes/open-a-terminal-on-your-dev-session-s-sandbox

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: Open a terminal on your dev session's sandbox
  version: subpackage_sandboxes.Open a terminal on your dev session's sandbox
  description: >-
    Opens an interactive shell in a sandbox that your own dev session for the
    agent holds. The protocol matches the deployment terminal. A request with no
    Origin header is refused, so send the server's own URL as Origin.
channels:
  /api/v1/accounts/{account}/dev-sessions/{agent}/sandboxes/{name}/terminal:
    description: >-
      Opens an interactive shell in a sandbox that your own dev session for the
      agent holds. The protocol matches the deployment terminal. A request with
      no Origin header is refused, so send the server's own URL as Origin.
    publish:
      operationId: >-
        subpackage_sandboxes.Open a terminal on your dev session's
        sandbox-publish
      summary: receiveOpenATerminalOnYourDevSessionsSandbox
      description: >-
        Shell output, as a binary frame of raw terminal bytes including escape
        sequences.
      message:
        name: receiveOpenATerminalOnYourDevSessionsSandbox
        title: receiveOpenATerminalOnYourDevSessionsSandbox
        description: >-
          Shell output, as a binary frame of raw terminal bytes including escape
          sequences.
        payload:
          $ref: '#/components/schemas/openATerminalOnYourDevSessionsSandbox_output'
    subscribe:
      operationId: >-
        subpackage_sandboxes.Open a terminal on your dev session's
        sandbox-subscribe
      summary: Client messages
      message:
        oneOf:
          - $ref: >-
              #/components/messages/subpackage_sandboxes.Open a terminal on your
              dev session's
              sandbox-client-0-sendOpenATerminalOnYourDevSessionsSandbox
          - $ref: >-
              #/components/messages/subpackage_sandboxes.Open a terminal on your
              dev session's
              sandbox-client-1-sendOpenATerminalOnYourDevSessionsSandbox
servers:
  Astropods:
    url: wss://astropods.com/
    protocol: wss
    x-default: true
components:
  messages:
    subpackage_sandboxes.Open a terminal on your dev session's sandbox-client-0-sendOpenATerminalOnYourDevSessionsSandbox:
      name: sendOpenATerminalOnYourDevSessionsSandbox
      title: sendOpenATerminalOnYourDevSessionsSandbox
      description: >-
        Keystrokes and pasted text for the shell, as a binary frame of UTF-8
        bytes.
      payload:
        $ref: '#/components/schemas/openATerminalOnYourDevSessionsSandbox_input'
    subpackage_sandboxes.Open a terminal on your dev session's sandbox-client-1-sendOpenATerminalOnYourDevSessionsSandbox:
      name: sendOpenATerminalOnYourDevSessionsSandbox
      title: sendOpenATerminalOnYourDevSessionsSandbox
      description: >-
        The terminal's size in characters, as a text frame. Send it on open and
        whenever the size changes.
      payload:
        $ref: '#/components/schemas/openATerminalOnYourDevSessionsSandbox_resize'
  schemas:
    openATerminalOnYourDevSessionsSandbox_output:
      type: string
      format: binary
      title: openATerminalOnYourDevSessionsSandbox_output
    openATerminalOnYourDevSessionsSandbox_input:
      type: string
      format: binary
      title: openATerminalOnYourDevSessionsSandbox_input
    openATerminalOnYourDevSessionsSandbox_resize:
      type: object
      properties:
        cols:
          type: integer
        rows:
          type: integer
        type:
          type: string
          description: Always resize.
      title: openATerminalOnYourDevSessionsSandbox_resize

```