Update the UI Config

PUT

https://api.contentful.com/spaces/:space_id/environments/:environment_id/ui_config

PUT

/spaces/:space_id/environments/:environment_id/ui_config

$ curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/ui_config \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "assetListViews": [
>     {
>       "id": "view",
>       "title": "title",
>       "views": [
>         {
>           "id": "view",
>           "title": "view",
>           "order": {
>             "fieldId": "field",
>             "direction": "'\''ascending'\'' | '\''descending'\''"
>           },
>           "displayedFieldIds": [],
>           "contentTypeId": "content",
>           "contentTypeIds?": [
>             "content"
>           ],
>           "searchText": "search",
>           "searchFilters?": [],
>           "roles": []
>         }
>       ]
>     }
>   ],
>   "entryListViews": [
>     {
>       "id": "view",
>       "title": "title",
>       "views": [
>         {
>           "id": "view",
>           "title": "view",
>           "order": {
>             "fieldId": "field",
>             "direction": "'\''ascending'\'' | '\''descending'\''"
>           },
>           "displayedFieldIds": [],
>           "contentTypeId": "content",
>           "contentTypeIds?": [
>             "content"
>           ],
>           "searchText": "search",
>           "searchFilters?": [],
>           "roles": []
>         }
>       ]
>     }
>   ],
>   "homeViews": [
>     {
>       "widgetId": "widget",
>       "widgetNamespace": "app"
>     }
>   ]
> }'

200UI Config_updateTheUiConfig_example

1 {
2   "assetListViews": [
3     {
4       "id": "view",
5       "title": "title",
6       "views": [
7         {
8           "id": "view",
9           "title": "view",
10           "order": {
11             "fieldId": "field",
12             "direction": "'ascending' | 'descending'"
13           },
14           "displayedFieldIds": [],
15           "contentTypeId": "content",
16           "contentTypeIds?": [
17             "content"
18           ],
19           "searchText": "search",
20           "searchFilters?": [],
21           "roles": []
22         }
23       ]
24     }
25   ],
26   "entryListViews": [
27     {
28       "id": "view",
29       "title": "title",
30       "views": [
31         {
32           "id": "view",
33           "title": "view",
34           "order": {
35             "fieldId": "field",
36             "direction": "'ascending' | 'descending'"
37           },
38           "displayedFieldIds": [],
39           "contentTypeId": "content",
40           "contentTypeIds?": [
41             "content"
42           ],
43           "searchText": "search",
44           "searchFilters?": [],
45           "roles": []
46         }
47       ]
48     }
49   ],
50   "homeViews": [
51     {
52       "widgetId": "widget",
53       "widgetNamespace": "app"
54     }
55   ],
56   "sys": {
57     "id": "6zbidGOqH...",
58     "type": "UIConfig",
59     "organization": {
60       "sys": {
61         "type": "Link",
62         "linkType": "Organization",
63         "id": "0D9ZC8rLWiw6x5qizZGiRs"
64       }
65     },
66     "space": {
67       "sys": {
68         "type": "Link",
69         "linkType": "Space",
70         "id": "yadj1kx9rmg0"
71       }
72     },
73     "environment": {
74       "sys": {
75         "type": "Link",
76         "linkType": "Environment",
77         "id": "staging"
78       }
79     },
80     "createdAt": "2026-02-14T20:33:08.000Z",
81     "createdBy": {
82       "sys": {
83         "type": "Link",
84         "linkType": "User",
85         "id": "7BslKh9TdKGOK41VmLDjFZ"
86       }
87     },
88     "updatedAt": "2026-02-14T20:33:08.000Z",
89     "updatedBy": {
90       "sys": {
91         "type": "Link",
92         "linkType": "User",
93         "id": "7BslKh9TdKGOK41VmLDjFZ"
94       }
95     }
96   }
97 }

You can use this endpoint to update the UI Config in your environment. These settings are visible to everyone in the environment.

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

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful