---
title: "Upsert a vocabulary in the terminology"
method: PUT
path: "/terminology/v1/vocabularies/{vocabularyKey}"
tags: ["Vocabularies"]
---

# Upsert a vocabulary in the terminology

`PUT /terminology/v1/vocabularies/{vocabularyKey}`

Upsert a vocabulary in the terminology.

## Path parameters

- `vocabularyKey` string, required

## Request body

- object
  - `title` string, required
  - `description` string, required

## Response `200`

A successful response when the vocabulary is replaced.

- V1Vocabulary
  - `key` string, required
  - `title` string, required
  - `description` string, required

## Other responses

- `201` — A successful response when the vocabulary is created.
- `400` — Returned when the request is malformed or invalid.
- `413` — Returned when the payload exceeds the max content size (100kB).

---

[API](https://skmtc.net/clinia/apis/terminology-api.md) · [All operations](https://skmtc.net/clinia/apis/terminology-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinia/terminology-api/revisions/3fce2e6b0ae5/schema)