Update a concept scheme

PATCH

https://api.contentful.com/organizations/:organization_id/taxonomy/concept-schemes/:concept_scheme_id

PATCH

/organizations/:organization_id/taxonomy/concept-schemes/:concept_scheme_id

$ curl -X PATCH https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/taxonomy/concept-schemes/2s0F7127ajju1AVToMaCtE \
>      -H "X-Contentful-Version: 1" \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json-patch+json" \
>      -d '[
>   {
>     "op": "add",
>     "path": "/prefLabel/en-US",
>     "value": "Sofas"
>   },
>   {
>     "op": "add",
>     "path": "/topConcepts/4",
>     "value": {
>       "sys": {
>         "id": "1Py5SjffQHkGGY3dZ02W14"
>       }
>     }
>   },
>   {
>     "op": "remove",
>     "path": "/concepts/12"
>   }
> ]'

200Taxonomy_updateAConceptScheme_example

1 {
2   "sys": {
3     "id": "2s0F7127ajju1AVToMaCtE",
4     "type": "TaxonomyConceptScheme",
5     "organization": {
6       "sys": {
7         "id": "0D9ZC8rLWiw6x5qizZGiRs",
8         "type": "Link",
9         "linkType": "Organization"
10       }
11     },
12     "createdAt": "2025-12-26T08:00:44.000Z",
13     "createdBy": {
14       "sys": {
15         "type": "Link",
16         "linkType": "User",
17         "id": "7BslKh9TdKGOK41VmLDjFZ"
18       }
19     },
20     "updatedAt": "2025-12-26T08:00:44.000Z",
21     "updatedBy": {
22       "sys": {
23         "type": "Link",
24         "linkType": "User",
25         "id": "4FLrUHftHW3v2BLi9fzfjU"
26       }
27     },
28     "version": 0
29   },
30   "uri": "",
31   "prefLabel": {
32     "en-US": "Home Products"
33   },
34   "definition": {
35     "en-US": ""
36   },
37   "topConcepts": [
38     {
39       "sys": {
40         "id": "1Py5SjffQHkGGY3dZ02W14",
41         "type": "Link",
42         "linkType": "TaxonomyConcept"
43       }
44     }
45   ],
46   "concepts": [
47     {
48       "sys": {
49         "id": "1Py5SjffQHkGGY3dZ02W14",
50         "type": "Link",
51         "linkType": "TaxonomyConcept"
52       }
53     }
54   ],
55   "totalConcepts": 1
56 }

Updates a taxonomy concept scheme using JSON Patch format. Include the current version in X-Contentful-Version; operations on unset fields require passing the full sub-object rather than a nested path.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

concept_scheme_idstringRequired

The ID of the concept scheme.

organization_idstringRequired

The ID of the organization.

Headers

X-Contentful-VersionstringRequired

Version of the concept scheme to update

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful