# Clad Labs API

**Canonical:** https://apis.io/apis/useclad-ai/useclad-ai-api/  
**Provider:** Clad Labs — https://apis.io/providers/useclad-ai/  
**Documentation:** https://docs.useclad.ai/api/quickstart.md

Clad Labs API is published by [Clad Labs](https://apis.io/providers/useclad-ai/) 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.

Clad Labs API as documented publicly: 23 operations. Contract generated from the documentation by API Evangelist (2026-10-29); not the provider's own document.

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| POST | `/ai/answer` | One‑shot, non‑conversational answer / article suggestions for a single question (honors `ai.mode` of `answer_first` / `suggest_articles`). |
| POST | `/ai/chat` | Conversational AI assistant turn (multi‑turn RAG grounded in published articles). This is what the in‑widget AI assistant uses. |
| POST | `/ai/escalate` | Mark an AI chat as escalated to a human (logs the deflection hand‑off). |
| GET | `/articles/{id}` | Fetch an article. |
| POST | `/attachments` | Upload a ticket‑form image (raw bytes, `X-Filename` header; image‑only + size‑capped). Returns a short‑lived signed handle to include in a submission. |
| GET | `/config` | Public Widget API |
| GET | `/conversations` | Public Widget API |
| POST | `/conversations` | Public Widget API |
| GET | `/conversations/{id}` | Public Widget API |
| GET | `/conversations/{id}/messages` | Public Widget API |
| POST | `/conversations/{id}/messages` | Public Widget API |
| POST | `/conversations/{id}/read` | Public Widget API |
| POST | `/events` | Ingest client analytics/audit events. |
| GET | `/forms` | List/fetch ticket forms. |
| GET | `/forms/{id}` | List/fetch ticket forms. |
| POST | `/forms/{id}/submissions` | Submit a ticket form. |
| GET | `/graphql` | Send your first authenticated query, create an issue, and read it back. |
| POST | `/graphql` | POST /graphql |
| POST | `/sessions/anonymous` | Public Widget API |
| POST | `/sessions/identify` | Public Widget API |
| POST | `/sessions/realtime-token` | Public Widget API |
| POST | `/sessions/refresh` | Public Widget API |
| POST | `/sessions/shutdown` | Public Widget API |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/useclad-ai/openapi/_ae-authored/useclad-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/useclad-ai/json-schema/useclad-ai-post-graphql-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/useclad-ai/json-schema/useclad-ai-post-conversations-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/useclad-ai/json-schema/useclad-ai-post-conversations-id-messages-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/useclad-ai/json-schema/useclad-ai-get-graphql-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/useclad-ai/json-schema/useclad-ai-post-sessions-identify-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/useclad-ai/json-schema/useclad-ai-post-graphql-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/useclad-ai/apis.yml

---

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