# ish Sessions API

**Canonical:** https://apis.io/apis/ishlabs-io/ishlabs-io-sessions-api/  
**Provider:** ish — https://apis.io/providers/ishlabs-io/  
**Base URL:** https://api.ishlabs.io  
**Documentation:** https://ishlabs.io/demo/developers

ish Sessions API is one of 6 APIs that [ish](https://apis.io/providers/ishlabs-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Sessions. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Open a session for one of your people inside your own environment, submit what they perceive turn by turn, and read back the decision they made and how it felt.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/sessions/{session_id}` | Get Session |
| POST | `/api/v1/sessions/{session_id}/close` | Close Session |
| DELETE | `/api/v1/sessions/{session_id}/observations` | Purge Session Observations |
| POST | `/api/v1/sessions/{session_id}/turns` | Submit Turn |
| GET | `/api/v1/workspaces/{workspace_id}/sessions` | List Sessions |
| POST | `/api/v1/workspaces/{workspace_id}/sessions` | Create Session |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/ishlabs-io/openapi/ishlabs-io-sessions-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ishlabs-io/json-schema/ishlabs-io-create-session-request-schema.json

## Other ish APIs (5)

- [ish Environments API](https://apis.io/apis/ishlabs-io/ishlabs-io-environments-api/)
- [ish Events API](https://apis.io/apis/ishlabs-io/ishlabs-io-events-api/)
- [ish People API](https://apis.io/apis/ishlabs-io/ishlabs-io-people-api/)
- [ish Tasks API](https://apis.io/apis/ishlabs-io/ishlabs-io-tasks-api/)
- [ish Usage API](https://apis.io/apis/ishlabs-io/ishlabs-io-usage-api/)

## Tags

Sessions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ishlabs-io/ishlabs-io-sessions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ishlabs-io/.