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

# Upsert a concept in a vocabulary

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

Upsert a concept in a vocabulary.

## Path parameters

- `vocabularyKey` string, required
- `conceptCode` string, required

## Request body

- V1Concept
  - `vocabularyKey` string, required
  - `code` string, required
  - `definition` string, required
  - `designation` object, required

## Response `200`

A successful response when the concept is replaced.

- V1Concept
  - `vocabularyKey` string, required
  - `code` string, required
  - `definition` string, required
  - `designation` object, required

## Other responses

- `201` — A successful response when the concept is created.
- `400` — Returned when the request is malformed or invalid.
- `404` — Returned when the vocabulary does not exist.
- `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)