Update an environment template

PUT

https://api.contentful.com/organizations/:organization_id/environment_templates/:template_id

PUT

/organizations/:organization_id/environment_templates/:template_id

$ curl -X PUT https://api.contentful.com/organizations/0D9ZC8rLWiw6x5qizZGiRs/environment_templates/46SummRPRBowauM8T5LjbR \
>      -H "X-Contentful-Version: 14" \
>      -H "Authorization: Bearer <token>"

200Content model templates_updateAnEnvironmentTemplate_example

1 {
2   "sys": {
3     "id": "2nZrYQn7N7xijNAOhkKUrH",
4     "type": "EnvironmentTemplate",
5     "createdAt": "2025-11-06T21:45:19.000Z",
6     "updatedAt": "2025-11-06T21:45:19.000Z",
7     "version": "1",
8     "createdBy": {
9       "sys": {
10         "type": "Link",
11         "linkType": "User",
12         "id": "75cxRYbSLlWMlCrN1tZGdP"
13       }
14     },
15     "updatedBy": {
16       "sys": {
17         "type": "Link",
18         "linkType": "User",
19         "id": "75cxRYbSLlWMlCrN1tZGdP"
20       }
21     },
22     "organization": {
23       "sys": {
24         "type": "Link",
25         "linkType": "Organization",
26         "id": "75gbeC7tWNTERE55diMpCN"
27       }
28     }
29   },
30   "name": "my-template",
31   "description": "My Template",
32   "versionName": "First Version",
33   "versionDescription": "First Version",
34   "entities": {
35     "contentTypeTemplates": [
36       {
37         "name": "Blogpost",
38         "description": "A blogpost content type",
39         "displayField": "title",
40         "fields": [
41           {
42             "id": "title",
43             "name": "title",
44             "type": "Text"
45           }
46         ],
47         "id": "blogpost"
48       }
49     ],
50     "editorInterfaceTemplates": [
51       {
52         "contentTypeTemplate": {
53           "sys": {
54             "id": "blogpost",
55             "linkType": "ContentTypeTemplate",
56             "type": "Link"
57           }
58         },
59         "controls": [
60           {
61             "fieldId": "title",
62             "widgetId": "urlEditor",
63             "widgetNamespace": "builtin",
64             "settings": {
65               "helpText": "help text"
66             }
67           }
68         ]
69       }
70     ]
71   },
72   "forTemplatedSpaces": "false"
73 }

Updates an environment template and implicitly creates a new version. Include X-Contentful-Version to lock against concurrent edits.

Authentication

AuthorizationBearer

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

Path parameters

organization_idstringRequired

The ID of the organization. Alphanumerical.

template_idstringRequired

The ID of the organization. Alphanumerical. For more information about this parameter, see https://www.contentful.com/developers/docs/references/content-management-api/#/introduction/updating-and-version-locking.

Headers

X-Contentful-VersionstringOptional

Version of the environment template to update

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful