---
title: "Remove the concept with id `c_id`."
method: DELETE
path: "/conceptschemes/{scheme_id}/c/{c_id}"
tags: ["Atramhasis"]
---

# Remove the concept with id \`c_id\`.

`DELETE /conceptschemes/{scheme_id}/c/{c_id}`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/conceptschemes/{scheme_id}/c/{c_id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/onroerenderfgoed/apis/atramhasis-api/docs/conceptschemes/:scheme_id/c/:c_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Remove the concept with id `c_id`. The response body will contain the last representation known by the service.

## Path parameters

- `scheme_id` string, required
- `c_id` string, required

## Response `200`

The concept or collection was deleted succesfully.

- union
  - ConceptDetail
    - `id` string
    - `type` 'concept', required
    - `labels` Label[], required
      - `type` string, required
      - `language` string, required: IANA language tag
      - `label` string, required
    - `notes` Note[]
      - `note` string
      - `type` string
      - `language` string
      - `markup` string, nullable
    - `sources` Source[]
      - `citation` string
      - `markup` string, nullable
    - `member_of` object[]
      - `id` string: A collection id
    - `related` object[]
      - `id` string: A concept id
    - `broader` object[]
      - `id` string: A concept id
    - `narrower` object[]
      - `id` string: A concept id
    - `matches` Matches
      - `broad` string[]
      - `close` string[]
      - `exact` string[]
      - `narrow` string[]
      - `related` string[]
    - `subordinate_arrays` object[]
      - `id` string: A collection id
    - `label` string
    - `uri` string
    - `concept_scheme` object
      - `uri` string
      - `labels` Label[]
        - `type` string, required
        - `language` string, required: IANA language tag
        - `label` string, required
  - CollectionDetail
    - `id` string: If the provider is set to have a manual id_generation_strategy
    - `type` 'collection', required
    - `labels` Label[], required
      - `type` string, required
      - `language` string, required: IANA language tag
      - `label` string, required
    - `notes` Note[]
      - `note` string
      - `type` string
      - `language` string
      - `markup` string, nullable
    - `sources` Source[]
      - `citation` string
      - `markup` string, nullable
    - `member_of` object[]
      - `id` string: A collection id
    - `members` object[]
      - `id` string: A concept or collection id
    - `superordinates` object[]
      - `id` string: A concept id
    - `infer_concept_relations` boolean
    - `label` string
    - `uri` string

## Other responses

- `400`: The concept or collection could not be deleted because the submitted json was invalid due to eg. validation errors.
- `404`: The conceptscheme `scheme_id` or the concept or collection `c_id` does not exist.
- `405`: The concept or collection could not be deleted because the conceptscheme `scheme_id` is a readonly conceptscheme.
- `409`: The concept or collection could not be deleted because Atramhasis has determined that it's still being used somewhere else. The response body will contain a message and a list of :term:`URI`'s that are using this concept.
- `500`: OpenAPI request/response validation failed

## Changes

- **2025-11-20** `d98571488187`: 2 breaking, 1 info
  - added `#/components/schemas/ConceptDetail, #/components/schemas/CollectionDetail` to the response body `oneOf` list for the response status `200`
  - the `errors` response's property type changed from `string` to `array` for status `400`
  - removed `#/components/schemas/ConceptRequest, subschema #2` from the response body `allOf` list for the response status `200`
- **2024-08-01** `20edc4da41fd`: 8 breaking, 1 info
  - the `allOf[#/components/schemas/ConceptRequest]/broader/items/id` response's property type changed from `integer` to `string` for status `200`
  - the `allOf[#/components/schemas/ConceptRequest]/id` response's property type changed from `integer` to `string` for status `200`
  - the `allOf[#/components/schemas/ConceptRequest]/member_of/items/id` response's property type changed from `integer` to `string` for status `200`
  - the `allOf[#/components/schemas/ConceptRequest]/members/items/id` response's property type changed from `integer` to `string` for status `200`
  - …5 more
- **2021-12-22** `042de7aa8903`: 2 info
  - api tag `Atramhasis` added
  - api tag `Concepts and collections` removed
- …earlier changes not shown

[Operation history](https://skmtc.dev/onroerenderfgoed/apis/atramhasis-api/changes/conceptschemes/:scheme_id/c/:c_id/delete.md)

---

[API](https://skmtc.dev/onroerenderfgoed/apis/atramhasis-api.md) - [All operations](https://skmtc.dev/onroerenderfgoed/apis/atramhasis-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onroerenderfgoed/apis/atramhasis-api/revisions/c2d0b54078a2?raw)