Upsert an experience by ID | Documentation

curl -X PUT https://api.contentful.com/spaces/spaceId/environments/environmentId/experiences/id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "string",
  "description": "string",
  "viewports": [
    {
      "id": "string",
      "query": "string",
      "displayName": "string",
      "previewSize": "string"
    }
  ],
  "designProperties": {},
  "dimensionKeyMap": {
    "designProperties": {}
  }
}'

{
  "sys": {
    "id": "string",
    "type": "string",
    "space": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "environment": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "template": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "urn": "string"
      }
    },
    "createdAt": "string",
    "updatedAt": "string",
    "archivedAt": "string",
    "archivedBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "archivedVersion": 1.1,
    "createdBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "updatedBy": {
      "sys": {
        "type": "string",
        "linkType": "string",
        "id": "string"
      }
    },
    "variant": "string",
    "variantType": "string",
    "variantDimension": "string",
    "publishedAt": "string",
    "publishedVersion": 1.1,
    "publishedCounter": 1.1,
    "firstPublishedAt": "string",
    "publishedBy": {
      "sys": {
        "type": "string",
        "linkType": "User",
        "id": "string"
      }
    },
    "localeStatus": {},
    "version": 1.1
  },
  "name": "string",
  "description": "string",
  "viewports": [
    {
      "id": "string",
      "query": "string",
      "displayName": "string",
      "previewSize": "string"
    }
  ],
  "designProperties": {},
  "dimensionKeyMap": {
    "designProperties": {}
  },
  "contentBindings": {
    "sys": {
      "type": "string",
      "linkType": "string",
      "urn": "string"
    },
    "parameters": {}
  },
  "metadata": {
    "tags": [
      {
        "sys": {
          "type": "string",
          "linkType": "string",
          "id": "string"
        }
      }
    ],
    "concepts": [
      {
        "sys": {
          "type": "string",
          "linkType": "string",
          "id": "string"
        }
      }
    ],
    "name": "string"
  },
  "slots": {}
}

Updates an experience by ID, or creates a new one with the specified ID if the experience does not exist.

Authentication

AuthorizationBearer

Contentful Management API token

Path parameters

spaceIdstringRequired

environmentIdstringRequired

idstringRequired

Query parameters

access_tokenstringOptional

Request

Body

namestringRequired

descriptionstringRequired

viewportslist of objectsRequired

designPropertiesmap from strings to maps from strings to objectsRequired

dimensionKeyMapobjectRequired

contentBindingsobjectOptional

metadataobjectOptional

slotsmap from strings to lists of objectsOptional

templateobjectOptional

Response

200

sysobject

namestring

descriptionstring

viewportslist of objects

designPropertiesmap from strings to maps from strings to objects

dimensionKeyMapobject

contentBindingsobject

metadataobject

slotsmap from strings to lists of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error