---
title: "Run shell command"
method: POST
path: "/session/{sessionID}/shell"
---

# Run shell command

`POST /session/{sessionID}/shell`

Execute a shell command within the session context and return the AI's response.

## Path parameters

- `sessionID` string, required

## Query parameters

- `directory` string

## Request body

- object
  - `agent` string, required
  - `model` object
    - `providerID` string, required
    - `modelID` string, required
  - `command` string, required

## Response `200`

Created message

- AssistantMessage
  - `id` string, required
  - `sessionID` string, required
  - `role` 'assistant', required
  - `time` object, required
    - `created` number, required
    - `completed` number
  - `error` union
    - ProviderAuthError
      - `name` 'ProviderAuthError', required
      - `data` object, required
        - `providerID` string, required
        - `message` string, required
    - UnknownError
      - `name` 'UnknownError', required
      - `data` object, required
        - `message` string, required
    - MessageOutputLengthError
      - `name` 'MessageOutputLengthError', required
      - `data` object, required
    - MessageAbortedError
      - `name` 'MessageAbortedError', required
      - `data` object, required
        - `message` string, required
    - APIError
      - `name` 'APIError', required
      - `data` object, required
        - `message` string, required
        - `statusCode` number
        - `isRetryable` boolean, required
        - `responseHeaders` object
        - `responseBody` string
  - `parentID` string, required
  - `modelID` string, required
  - `providerID` string, required
  - `mode` string, required
  - `path` object, required
    - `cwd` string, required
    - `root` string, required
  - `summary` boolean
  - `cost` number, required
  - `tokens` object, required
    - `input` number, required
    - `output` number, required
    - `reasoning` number, required
    - `cache` object, required
      - `read` number, required
      - `write` number, required
  - `finish` string

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.net/arctic-cli/apis/arctic.md) · [All operations](https://skmtc.net/arctic-cli/apis/arctic/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arctic-cli/arctic/versions/d64a58bed245/schema)