Sign in

v3

latestOpenAPI 3.0.02026-08-081996601.2 MB
Glossaries

Create glossary

Creates a new glossary. A glossary is a reusable mapping of abbreviations, acronyms, and shorthand to their expansions. When terms in a user input event match glossary entries, the platform appends the matched terms and their expansions to the event as a hint.

post/v2/glossaries

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Request body

keystring

A user-provided key that uniquely identifies a glossary.

namestring required

Human-readable name for the glossary.

descriptionstring

A description of what this glossary covers.

Example request

{
  "key": "eng-acronyms",
  "name": "Engineering Acronyms",
  "description": "Common engineering and infrastructure acronyms used by the platform team."
}

Response

The created glossary.

keystring required

A user-provided key that uniquely identifies a glossary.

namestring required

Human-readable name for the glossary.

descriptionstring

A description of what this glossary covers.

num_entriesinteger

The number of entries currently in the glossary.

created_atstring date-time

Timestamp when the glossary was created.

updated_atstring date-time

Timestamp when the glossary was last updated.

Example response

{
  "key": "eng-acronyms",
  "name": "Engineering Acronyms",
  "description": "Common engineering and infrastructure acronyms used by the platform team.",
  "num_entries": 142,
  "created_at": "2026-03-01T10:00:00Z",
  "updated_at": "2026-03-15T14:30:00Z"
}