---
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}`

## Request

- Base URL: `https://.clinia.cloud`
- URL: `https://.clinia.cloud/terminology/v1/vocabularies/{vocabularyKey}`
- Auth: API key in header `X-Clinia-API-Key`

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.dev/clinia/apis/terminology-api.md) - [All operations](https://skmtc.dev/clinia/apis/terminology-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clinia/apis/terminology-api/revisions/3fce2e6b0ae5?raw)