Create or update an extension

PUT

https://api.contentful.com/spaces/:space_id/environments/:environment_id/extensions/:extension_id

PUT

/spaces/:space_id/environments/:environment_id/extensions/:extension_id

$ curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/extensions/0xvkPW9FdQ1kkWlWZ8ga4x \
>      -H "X-Contentful-Version: 1" \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "extension": {
>     "src": "https://example.com/my",
>     "name": "My awesome extension",
>     "fieldTypes": [
>       {
>         "type": "Symbol"
>       },
>       {
>         "type": "Text"
>       }
>     ],
>     "sidebar": false
>   }
> }'

200UI Extensions_createOrUpdateAnExtension_example

1 {
2   "extension": {
3     "src": "https://example.com/my",
4     "name": "My awesome extension",
5     "fieldTypes": [
6       {
7         "type": "Symbol"
8       },
9       {
10         "type": "Text"
11       }
12     ],
13     "sidebar": false
14   },
15   "sys": {
16     "id": "0xvkPW9FdQ1kkWlWZ8ga4x",
17     "type": "Extension",
18     "version": 1,
19     "space": {
20       "sys": {
21         "type": "Link",
22         "linkType": "Space",
23         "id": "yadj1kx9rmg0"
24       }
25     },
26     "environment": {
27       "sys": {
28         "type": "Link",
29         "linkType": "Environment",
30         "id": "staging"
31       }
32     },
33     "createdAt": "2025-07-04T20:43:40.000Z",
34     "createdBy": {
35       "sys": {
36         "type": "Link",
37         "linkType": "User",
38         "id": "7BslKh9TdKGOK41VmLDjFZ"
39       }
40     },
41     "updatedAt": "2025-07-04T20:43:40.000Z",
42     "updatedBy": {
43       "sys": {
44         "type": "Link",
45         "linkType": "User",
46         "id": "4FLrUHftHW3v2BLi9fzfjU"
47       }
48     }
49   }
50 }

Use this endpoint to create a new extension with a specified ID, or to update a specific extension via its ID. When updating an existing extension, you need to specify the last version of the extension you are updating with X-Contentful-Version.

Authentication

AuthorizationBearer

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

Path parameters

space_idstringRequired

ID of the space in form of a string

environment_idstringRequired

ID of the environment in form of a string

extension_idstringRequired

ID of the extension in form of a string

Headers

X-Contentful-VersionstringOptional

Version of the extension to update

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful