Update a concept

PATCH

https://api.contentful.com/organizations/:organization_id/taxonomy/concepts/:concept_id

PATCH

/organizations/:organization_id/taxonomy/concepts/:concept_id

$ curl -X PATCH https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/taxonomy/concepts/3kZdDUXy9n0l2Xi2cq8TPc \
>      -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": "/altLabels/2",
>     "value": {
>       "en-US": "Divans"
>     }
>   },
>   {
>     "op": "remove",
>     "path": "/broader/0"
>   }
> ]'

200Taxonomy_updateAConcept_example

1 {
2   "sys": {
3     "id": "3kZdDUXy9n0l2Xi2cq8TPc",
4     "type": "TaxonomyConcept",
5     "organization": {
6       "sys": {
7         "id": "0D9ZC8rLWiw6x5qizZGiRs",
8         "type": "Link",
9         "linkType": "Organization"
10       }
11     },
12     "createdAt": "2025-05-28T17:45:03.000Z",
13     "createdBy": {
14       "sys": {
15         "type": "Link",
16         "linkType": "User",
17         "id": "7BslKh9TdKGOK41VmLDjFZ"
18       }
19     },
20     "updatedAt": "2025-05-28T17:45:03.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": "Sofas"
33   },
34   "altLabels": {
35     "en-US": [
36       "Couches",
37       "Settees"
38     ]
39   },
40   "hiddenLabels": {
41     "en-US": [
42       "Davenports"
43     ]
44   },
45   "notations": [
46     "FURN0017B"
47   ],
48   "note": {
49     "en-US": ""
50   },
51   "changeNote": {
52     "en-US": ""
53   },
54   "definition": {
55     "en-US": ""
56   },
57   "editorialNote": {
58     "en-US": ""
59   },
60   "example": {
61     "en-US": ""
62   },
63   "historyNote": {
64     "en-US": ""
65   },
66   "scopeNote": {
67     "en-US": ""
68   },
69   "broader": [
70     {
71       "sys": {
72         "id": "1Py5SjffQHkGGY3dZ02W14",
73         "type": "Link",
74         "linkType": "TaxonomyConcept"
75       }
76     }
77   ],
78   "related": [
79     {
80       "sys": {
81         "id": "5abcWINB018mASQ5Fdrkbj",
82         "type": "Link",
83         "linkType": "TaxonomyConcept"
84       }
85     }
86   ],
87   "conceptSchemes": [
88     {
89       "sys": {
90         "type": "Link",
91         "linkType": "TaxonomyConceptScheme",
92         "id": "2s0F7127ajju1AVToMaCtE"
93       }
94     }
95   ]
96 }

Updates a taxonomy concept 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_idstringRequired

The ID of the concept.

organization_idstringRequired

The ID of the organization.

Headers

X-Contentful-VersionstringRequired

Version of the concept to update

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful