---
title: "Upsert glossary entries"
method: POST
path: "/v2/glossaries/{glossary_key}/entries"
tags: ["Glossaries"]
---

# Upsert glossary entries

`POST /v2/glossaries/{glossary_key}/entries`

Upserts entries into a glossary in bulk. Entries with existing terms are updated. New terms are inserted. The platform rebuilds the glossary index after the upsert. Agents use the updated glossary after the rebuild completes.

## Path parameters

- `glossary_key` string, required — A user-provided key that uniquely identifies a glossary.

## Headers

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

## Request body

- UpsertGlossaryEntriesRequest — Request to upsert entries into a glossary in bulk. Entries with existing terms are updated; new terms are inserted. The platform rebuilds the glossary index after the upsert. Agents use the updated glossary after the rebuild completes.
  - `entries` object, required — A map of terms to their expanded forms. Keys are terms (1–200 characters); values are expansions (1–1000 characters).

## Response `204`

The entries are upserted. The index rebuild completes asynchronously.

## Other responses

- `400` — The request was malformed.
- `403` — Permissions do not allow modifying this glossary.
- `404` — Glossary not found.

---

[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/83554494d7f8/schema)