---
title: "Create glossary"
method: POST
path: "/v2/glossaries"
tags: ["Glossaries"]
---

# Create glossary

`POST /v2/glossaries`

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.

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Request body

- CreateGlossaryRequest — Request to create a new glossary.
  - `key` string — A user-provided key that uniquely identifies a glossary.
  - `name` string, required — Human-readable name for the glossary.
  - `description` string — A description of what this glossary covers.

## Response `201`

The created glossary.

- Glossary — A reusable mapping of terms to their expanded forms. When abbreviations, acronyms, or domain-specific shorthand in a user input event match glossary terms, the platform appends the matched terms and their expansions to the event as a hint. The agent decides how to use them.
  - `key` string, required — A user-provided key that uniquely identifies a glossary.
  - `name` string, required — Human-readable name for the glossary.
  - `description` string — A description of what this glossary covers.
  - `num_entries` integer — The number of entries currently in the glossary.
  - `created_at` string, date-time — Timestamp when the glossary was created.
  - `updated_at` string, date-time — Timestamp when the glossary was last updated.

## Other responses

- `400` — The request was malformed.
- `403` — Permissions do not allow creating glossaries.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/revisions/a95087fe3a20/schema)