# cdbx API

**Canonical:** https://apis.io/apis/cdbx-ai/cdbx-ai-api/  
**Provider:** cdbx — https://apis.io/providers/cdbx-ai/  
**Documentation:** https://cdbx.ai/docs/how-to-use-cdbx/runner-api

cdbx API is one of 2 APIs that [cdbx](https://apis.io/providers/cdbx-ai/) 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.

cdbx API as documented publicly: 17 operations. Contract generated from the documentation by API Evangelist (2026-11-04); not the provider's own document.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/runner` | GET /api/v1/runner |
| POST | `/api/v1/runner/execute` | POST /api/v1/runner/execute |
| GET | `/api/v1/runner/languages` | List supported languages |
| POST | `/api/v1/runner/run/async` | Async execution (streaming) |
| POST | `/api/v1/runner/sessions` | Create a session |
| DELETE | `/api/v1/runner/sessions/{id}` | Delete a session |
| POST | `/api/v1/runner/sessions/{id}/files` | Write files to a session |
| POST | `/api/v1/runner/sessions/{id}/run` | Run in a session |
| POST | `/check` | Syntax/type check without executing |
| POST | `/execute` | Execute code and return output |
| GET | `/languages` | List supported languages |
| POST | `/run/async` | Start async execution, get job ID |
| POST | `/sessions` | Create a persistent session (IDE mode) |
| DELETE | `/sessions/{id}` | Delete a session |
| POST | `/sessions/{id}/files` | Write files to a session |
| POST | `/sessions/{id}/run` | Execute in a session |
| GET | `/ws/{jobid}` | WebSocket stream for async job |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/cdbx-ai/openapi/_ae-authored/cdbx-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/cdbx-ai/json-schema/cdbx-ai-post-check-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cdbx-ai/json-schema/cdbx-ai-post-execute-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cdbx-ai/json-schema/cdbx-ai-post-run-async-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cdbx-ai/json-schema/cdbx-ai-post-check-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/cdbx-ai/json-schema/cdbx-ai-post-execute-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/cdbx-ai/json-schema/cdbx-ai-post-sessions-id-run-request-schema.json

## Other cdbx APIs (1)

- [CDBX Runner API](https://apis.io/apis/cdbx-ai/cdbx-runner-api/)

---

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