# ish People API

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

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

Find the person a session should run as. Read and search the pool you can draw on: the people your workspace owns, plus the ones published in the shared ish library. Read-only at this version.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/workspaces/{workspace_id}/people` | List People |
| POST | `/api/v1/workspaces/{workspace_id}/people` | Create Person |
| GET | `/api/v1/workspaces/{workspace_id}/people/counts` | Get People Counts |
| POST | `/api/v1/workspaces/{workspace_id}/people/generation-jobs` | Create Generation Job |
| GET | `/api/v1/workspaces/{workspace_id}/people/generation-jobs/{job_id}` | Get Generation Job |
| POST | `/api/v1/workspaces/{workspace_id}/people/generation-jobs/{job_id}/cancel` | Cancel Generation Job |
| GET | `/api/v1/workspaces/{workspace_id}/people/schema` | Get People Schema |
| POST | `/api/v1/workspaces/{workspace_id}/people/search` | Search People |
| DELETE | `/api/v1/workspaces/{workspace_id}/people/{person_id}` | Archive Person |
| GET | `/api/v1/workspaces/{workspace_id}/people/{person_id}` | Get Person |
| PATCH | `/api/v1/workspaces/{workspace_id}/people/{person_id}` | Update Person |
| POST | `/api/v1/workspaces/{workspace_id}/people/{person_id}/restore` | Restore Person |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/ishlabs-io/openapi/ishlabs-io-people-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ishlabs-io/json-schema/ishlabs-io-public-person-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/ishlabs-io/json-schema/ishlabs-io-public-person-create-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 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

People

---

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