# Zespan API

**Canonical:** https://apis.io/apis/zespan/zespan-api/  
**Provider:** Zespan — https://apis.io/providers/zespan/  
**Base URL:** https://api.zespan.com  
**Documentation:** https://docs.zespan.com/reference/model-lifecycle-feed.md

Zespan API is one of 2 APIs that [Zespan](https://apis.io/providers/zespan/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Zespan API as documented publicly: 12 operations. Contract generated from the documentation by API Evangelist (2026-10-19); not the provider's own document.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/handle` | POST /handle |
| POST | `/v1/auth/device/code` | POST /v1/auth/device/code |
| POST | `/v1/ingest` | Ingest trace events |
| POST | `/v1/ingest/outcomes` | POST /v1/ingest/outcomes |
| GET | `/v1/model-catalogue` | GET /v1/model-catalogue returns the full bundled feed — every entry, not scoped to a project — for any project member. |
| GET | `/v1/orgs/{orgid}/policies` | Org-wide policy inventory, grouped by policy id |
| GET | `/v1/orgs/{orgid}/policy-applies` | Recent policy applies across every project in the org |
| GET | `/v1/prompts` | GET /v1/prompts |
| POST | `/v1/prompts/{name}/versions/{version}/gate` | Gate a merge or deploy on a prompt version's evaluation quality |
| GET | `/v1/sdk/config` | If the server version is higher, the SDK makes a single background request to GET /v1/sdk/config and applies the returned configuration rules immediately. |
| POST | `/v2/enqueue` | POST /v2/enqueue |
| POST | `/webhooks/zespan` | Webhooks — receive real-time alert notifications |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/zespan/refs/heads/main/openapi/_ae-authored/zespan-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/zespan/refs/heads/main/json-schema/zespan-post-webhooks-zespan-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/zespan/refs/heads/main/json-schema/zespan-post-v1-prompts-name-versions-version-gate-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/zespan/refs/heads/main/json-schema/zespan-get-v1-orgs-orgid-policies-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/zespan/refs/heads/main/json-schema/zespan-get-v1-sdk-config-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/zespan/refs/heads/main/json-schema/zespan-get-v1-orgs-orgid-policy-applies-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/zespan/refs/heads/main/json-schema/zespan-post-webhooks-zespan-response-schema.json

## Other Zespan APIs (1)

- [Zespan API](https://apis.io/apis/zespan/zespan-api-2/)

---

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