Create a release | Documentation

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 '{
  "entities": {
    "items": [
      {
        "sys": {
          "id": "",
          "linkType": "",
          "type": "Link"
        }
      }
    ]
  },
  "title": ""
}'

{
  "items": [
    {
      "entities": [
        {
          "items": [
            {
              "id": "",
              "linkType": "",
              "type": "Link"
            }
          ],
          "sys": {
            "type": "Array"
          }
        }
      ],
      "sys": {
        "archivedAt": "2020-01-01T13:00:00.000Z",
        "archivedBy": {
          "sys": {
            "id": "7BslKh9TdKGOK41VmLDjFZ",
            "linkType": "User",
            "type": "Link"
          }
        },
        "createdAt": "2025-07-05T09:25:43.000Z",
        "createdBy": {
          "sys": {
            "id": "7BslKh9TdKGOK41VmLDjFZ",
            "linkType": "User",
            "type": "Link"
          }
        },
        "environment": {
          "sys": {
            "id": "staging",
            "linkType": "Environment",
            "type": "Link"
          }
        },
        "space": {
          "sys": {
            "id": "yadj1kx9rmg0",
            "linkType": "Space",
            "type": "Link"
          }
        },
        "status": "",
        "type": "Release",
        "updatedAt": "2025-07-05T09:25:43.000Z",
        "updatedBy": {
          "sys": {
            "id": "7BslKh9TdKGOK41VmLDjFZ",
            "linkType": "User",
            "type": "Link"
          }
        },
        "version": 0
      },
      "title": ""
    }
  ],
  "limit": 0,
  "sys": {
    "type": "Array"
  },
  "total": 0
}

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-TypestringOptional

Content-Type

Response

Created - Resource created successfully