Gladly · Schema
Gladly Conversation
Schema for a Conversation in the Gladly REST API. A Conversation is the unified container for all interactions with a single Customer across channels and time.
Customer ServiceCXContact CenterAI Customer ServiceConversationsSidekick AIHeroVoiceChatSMSEmailHelp CenterWebhookKnowledge Base
Properties
| Name | Type | Description |
|---|---|---|
| id | string | Gladly-assigned conversation identifier. |
| customerId | string | Customer the conversation belongs to. |
| status | string | Current conversation status. |
| channel | string | Primary channel the conversation is currently active on. |
| assignee | object | |
| topics | array | |
| notes | array | |
| createdAt | string | |
| modifiedAt | string | |
| closedAt | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://api-evangelist.com/schemas/gladly/gladly-conversation-schema.json",
"title": "Gladly Conversation",
"description": "Schema for a Conversation in the Gladly REST API. A Conversation is the unified container for all interactions with a single Customer across channels and time.",
"type": "object",
"required": ["id"],
"properties": {
"id": {"type": "string", "description": "Gladly-assigned conversation identifier."},
"customerId": {"type": "string", "description": "Customer the conversation belongs to."},
"status": {
"type": "string",
"description": "Current conversation status.",
"enum": ["OPEN", "WAITING", "CLOSED", "DELETED"]
},
"channel": {
"type": "string",
"description": "Primary channel the conversation is currently active on.",
"enum": ["EMAIL", "VOICE", "SMS", "CHAT", "FACEBOOK_MESSENGER", "INSTAGRAM", "WHATSAPP", "TASK"]
},
"assignee": {
"type": "object",
"properties": {
"agentId": {"type": "string"},
"inboxId": {"type": "string"}
}
},
"topics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {"type": "string"},
"name": {"type": "string"}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {"type": "string"},
"content": {"type": "string"},
"agentId": {"type": "string"},
"createdAt": {"type": "string", "format": "date-time"}
}
}
},
"createdAt": {"type": "string", "format": "date-time"},
"modifiedAt": {"type": "string", "format": "date-time"},
"closedAt": {"type": "string", "format": "date-time"}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/gladly-conversation"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.