Create a release

POST

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

POST

/spaces/:space_id/environments/:environment_id/releases

$ curl -X POST https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/releases \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "title": "",
>   "entities": {
>     "items": [
>       {
>         "sys": {
>           "id": "",
>           "type": "Link",
>           "linkType": ""
>         }
>       }
>     ]
>   }
> }'

201Releases

1 {
2   "sys": {
3     "type": "Array"
4   },
5   "limit": 0,
6   "total": 0,
7   "items": [
8     {
9       "sys": {
10         "type": "Release",
11         "space": {
12           "sys": {
13             "type": "Link",
14             "linkType": "Space",
15             "id": "yadj1kx9rmg0"
16           }
17         },
18         "environment": {
19           "sys": {
20             "type": "Link",
21             "linkType": "Environment",
22             "id": "staging"
23           }
24         },
25         "status": "",
26         "version": 0,
27         "archivedAt": "2020-01-01T13:00:00.000Z",
28         "archivedBy": {
29           "sys": {
30             "type": "Link",
31             "linkType": "User",
32             "id": "7BslKh9TdKGOK41VmLDjFZ"
33           }
34         },
35         "createdAt": "2025-07-05T09:25:43.000Z",
36         "createdBy": {
37           "sys": {
38             "type": "Link",
39             "linkType": "User",
40             "id": "7BslKh9TdKGOK41VmLDjFZ"
41           }
42         },
43         "updatedAt": "2025-07-05T09:25:43.000Z",
44         "updatedBy": {
45           "sys": {
46             "type": "Link",
47             "linkType": "User",
48             "id": "7BslKh9TdKGOK41VmLDjFZ"
49           }
50         }
51       },
52       "title": "",
53       "entities": [
54         {
55           "sys": {
56             "type": "Array"
57           },
58           "items": [
59             {
60               "id": "",
61               "type": "Link",
62               "linkType": ""
63             }
64           ]
65         }
66       ]
67     }
68   ]
69 }

Creates a new release with an auto-generated ID.

Use the entities.items[] shape that matches the release version and the space’s publishing mode:

Release.v1: direct Entry or Asset links.
Release.v2 with entry-based publishing: entity plus action, where action is publish or unpublish.
Release.v2 with locale-based publishing: entity plus add and remove.

Only locale-based publishing uses add and remove. In that mode, each entity item must include both properties, and every environment locale must appear exactly once across add.fields["*"] and remove.fields["*"].

Creates a new release with an auto-generated ID. Use the `entities.items[]` shape that matches the release version and the space's publishing mode: * `Release.v1`: direct Entry or Asset links. * `Release.v2` with entry-based publishing: `entity` plus `action`, where `action` is `publish` or `unpublish`. * `Release.v2` with locale-based publishing: `entity` plus `add` and `remove`. Only locale-based publishing uses `add` and `remove`. In that mode, each entity item must include both properties, and every environment locale must appear exactly once across `add.fields["*"]` and `remove.fields["*"]`.

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

Created - Resource created successfully