Gladly Vocabulary is a controlled vocabulary published by Gladly on the APIs.io network, defining 27 terms.
Defined terms include Agents, Answer Management, Audiences, Business Hours, and Communications.
A controlled vocabulary pins the words an API’s schemas, parameters and documentation use to one agreed definition each — the shared language a human or an agent needs to read the API the same way its authors do.
Agents
Service desk users and their state, including the Call Recorder availability.
Answer Management
Author, update, and delete knowledge-base Answers used by Sidekick AI and agent suggestions.
Audiences
Segmentation of customers and answers for scoped delivery (region, brand, language).
Business Hours
Define when channels and inboxes are staffed, including holidays and overrides.
Communications
Send outbound SMS and email directly through the Gladly API.
Conversations
Unified, channel-agnostic customer interactions across voice, chat, SMS, email, and social, including items, topics, notes, replies, and redactions.
Customer Lookup
External "Lookup API" pattern where Gladly fetches customer context from a brand-owned endpoint.
Customers
Unified customer profile with normalized emails, phones, channels, external IDs, and custom attributes.
Events
Read the platform event stream for activity that occurred against the organization.
Export
Schedule, list, and download bulk data exports of agents, conversations, customers, and metrics.
Freeform Topics
Free-text topic application not constrained to the curated topic taxonomy.
Inboxes
Logical work-queues that route conversations and tasks to agents.
Organization
Read organization-level configuration.
Proactive Conversations
Initiate outbound conversations to customers from automated workflows.
Public Answer
Help Center–visible answers and the search surface that powers self-service.
Reports
Standard and work-session reports for staffing, productivity, and customer outcomes.
Sidekick AI
Gladly's AI assistant that drafts replies, automates resolutions, and reads from Answers.
Tasks
Discrete work items assignable to agents or inboxes, with comments and due dates.
Teams
Groups of agents that share routing and reporting boundaries.
Topics
Curated taxonomy applied to conversations for reporting and routing.
User Identity
Issue signed JWT identities for authenticated chat sessions.
Webhooks
Subscribe brand-owned HTTPS endpoints to platform events (conversation, message, task, customer, agent state).
Rate Limit
Default 10 req/sec per organization with Ratelimit-Limit-Second / Ratelimit-Remaining-Second response headers and 429 throttling.
Rich Content
Markdown, structured cards, quick replies, and attachments rendered in supported channels.
Lookup API
Brand-hosted endpoint Gladly calls to enrich a conversation with first-party customer data.
App Platform
Embedded app/connector framework for surfacing third-party experiences inside the Gladly Hero agent UI.
Hero
Gladly's agent workspace (formerly "Gladly Team") used by service representatives.
Every vocabulary here is available over the APIs.io API and to AI agents over MCP. Vocabularies is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.