# ish Environments API

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

ish Environments 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 3 JSON Schema definitions. Tagged areas include Environment. The published artifact set on APIs.io includes an OpenAPI specification and 3 JSON Schemas.

Register the targets your sessions run against, and the declared versions of each one. A registered environment carries its own operating notes and default action vocabulary, so a session only has to name it.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| DELETE | `/api/v1/environment-versions/{version_id}` | Delete Environment Version |
| GET | `/api/v1/environment-versions/{version_id}` | Get Environment Version |
| PATCH | `/api/v1/environment-versions/{version_id}` | Update Environment Version |
| POST | `/api/v1/environment-versions/{version_id}/set-default` | Set Default Environment Version |
| DELETE | `/api/v1/environments/{environment_id}` | Delete Environment |
| GET | `/api/v1/environments/{environment_id}` | Get Environment |
| PATCH | `/api/v1/environments/{environment_id}` | Update Environment |
| GET | `/api/v1/environments/{environment_id}/versions` | List Environment Versions |
| POST | `/api/v1/environments/{environment_id}/versions` | Create Environment Version |
| GET | `/api/v1/workspaces/{workspace_id}/environments` | List Environments |
| POST | `/api/v1/workspaces/{workspace_id}/environments` | Create Environment |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/ishlabs-io/openapi/ishlabs-io-environments-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ishlabs-io/json-schema/ishlabs-io-environment-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/ishlabs-io/json-schema/ishlabs-io-create-environment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/ishlabs-io/json-schema/ishlabs-io-environment-version-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/ishlabs-io/apis.yml

## Other ish APIs (5)

- [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 Sessions API](https://apis.io/apis/ishlabs-io/ishlabs-io-sessions-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

Environment

---

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