How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Clad Labs API

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.

Clad Labs API is published by Clad Labs on the 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.

This API exposes 23 operations across 20 paths, organized into 9 resource areas, and defines 6 schemas. It is described by OpenAPI 3.1.0, at version 2026-10-29.

23 operations 20 paths 6 schemas 8 GET15 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2026-10-29
Authentication
HTTP Bearer
Resource Areas
9

Authentication & Security 1

Clad Labs API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearer). By default, every request must be authenticated.

Paths & Operations 23

Across 20 paths, the API surfaces 23 operations — 8 GET, 15 POST. They span 9 resource areas: Ai, Articles, Attachments, Config, Conversations, Events, Forms, Graphql, Sessions. Each is listed below with its method, path, parameters, and response codes.

Ai 3
POST
/ai/answer
One‑shot, non‑conversational answer / article suggestions for a single question (honors ai.mode of answerfirst / suggestarticles).
post_ai_answer → 201
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_chat → 201
POST
/ai/escalate
Mark an AI chat as escalated to a human (logs the deflection hand‑off).
post_ai_escalate → 201
Articles 1
GET
/articles/{id}
Fetch an article.
get_articles_id 1 param → 200
Attachments 1
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.
post_attachments → 201
Config 1
GET
/config
Public Widget API
get_config 2 params → 200
Conversations 6
GET
/conversations
Public Widget API
get_conversations → 200
POST
/conversations
Public Widget API
post_conversations body → 201
GET
/conversations/{id}
Public Widget API
get_conversations_id 1 param → 200
GET
/conversations/{id}/messages
Public Widget API
get_conversations_id_messages 1 param → 200
POST
/conversations/{id}/messages
Public Widget API
post_conversations_id_messages 1 param body → 201
POST
/conversations/{id}/read
Public Widget API
post_conversations_id_read 1 param → 201
Events 1
POST
/events
Ingest client analytics/audit events.
post_events → 201
Forms 3
GET
/forms
List/fetch ticket forms.
get_forms → 200
GET
/forms/{id}
List/fetch ticket forms.
get_forms_id 1 param → 200
POST
/forms/{id}/submissions
Submit a ticket form.
post_forms_id_submissions 1 param → 201
Graphql 2
GET
/graphql
Send your first authenticated query, create an issue, and read it back.
get_graphql → 200
POST
/graphql
POST /graphql
post_graphql body → 201
Sessions 5
POST
/sessions/anonymous
Public Widget API
post_sessions_anonymous → 201
POST
/sessions/identify
Public Widget API
post_sessions_identify body → 201
POST
/sessions/realtime-token
Public Widget API
post_sessions_realtime_token → 201
POST
/sessions/refresh
Public Widget API
post_sessions_refresh → 201
POST
/sessions/shutdown
Public Widget API
post_sessions_shutdown → 201

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are PostConversationsRequest (5 properties), PostConversationsIdMessagesRequest (2 properties), PostSessionsIdentifyRequest (1 property), PostGraphqlResponse (1 property). Each schema is shown below with its type and property counts.

PostConversationsRequest
object
5 properties
PostConversationsIdMessagesRequest
object
2 properties 1 required
GetGraphqlResponse
object
1 property
PostGraphqlRequest
object
1 property
PostGraphqlResponse
object
1 property
PostSessionsIdentifyRequest
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

useclad-ai-openapi-generated.yml Raw ↑
Where this information came from

This is an independent, third-party profile of Clad Labs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.