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

# Pause Session

> Pause a running session

Pause a running session's sandbox. The agent stops executing and the sandbox is suspended. Use [Resume](/api-reference/sessions/resume) to continue.

## Request

```bash theme={null}
curl -X POST https://api.tapkit.ai/v1/sessions/{session_id}/pause \
  -H "X-API-Key: joot_your_api_key"
```

### Path Parameters

| Parameter    | Type     | Description            |
| ------------ | -------- | ---------------------- |
| `session_id` | `string` | The session identifier |

## Response

**Status: 204 No Content**

No response body.

## Examples

### Python

```python theme={null}
import requests

requests.post(
    f"https://api.tapkit.ai/v1/sessions/{session_id}/pause",
    headers={"X-API-Key": "joot_..."}
)
```

## Related Endpoints

* [Resume](/api-reference/sessions/resume) - Resume a paused session
* [Stop](/api-reference/sessions/stop) - Kill the session entirely
* [Get Session](/api-reference/sessions/get-session) - Check session status