Create or update an environment alias | Documentation

curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environment_aliases/development \
     -H "X-Contentful-Version: 1" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "environment": {
    "sys": {
      "type": "Link",
      "linkType": "Environment",
      "id": "staging"
    }
  }
}'

{
  "sys": {
    "type": "Environment Alias",
    "id": "development",
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "yadj1kx9rmg0"
      }
    },
    "version": 2
  },
  "environment": {
    "sys": {
      "type": "Link",
      "linkType": "Environment",
      "id": "staging"
    }
  }
}

Creates a new environment alias or changes the environment it references. When updating, include the current alias version in 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 the form of a string

environment_alias_idstringRequired

ID of the environment alias in form of a string

Headers

X-Contentful-VersionstringOptional

Version of the environment alias to update

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful