Upsert a Destination Node by ID

PUT

https://api.contentful.com/spaces/:spaceId/environments/:environmentId/destinations/:destinationId/nodes/:nodeId

PUT

/spaces/:spaceId/environments/:environmentId/destinations/:destinationId/nodes/:nodeId

curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environments/master/destinations/4RqKkGJqLHpMiomHuILv5N/nodes/6BslKh9TdKGOK41VmLDjFZ \
     -H "X-Contentful-Version: 1" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "type": "DestinationFolderNode",
  "properties": [
    {
      "path": "products"
    }
  ]
}'

200Updated

{
  "name": "name",
  "parent": {
    "sys": {
      "id": "id",
      "linkType": "Destination",
      "type": "Link"
    }
  },
  "properties": [
    {
      "path": "products",
      "type": "Path"
    }
  ],
  "sys": {
    "createdAt": "createdAt",
    "createdBy": {
      "sys": {
        "id": "id",
        "linkType": "linkType",
        "type": "Link"
      }
    },
    "destination": {
      "sys": {
        "id": "id",
        "linkType": "linkType",
        "type": "Link"
      }
    },
    "environment": {
      "sys": {
        "id": "id",
        "linkType": "linkType",
        "type": "Link"
      }
    },
    "firstPublishedAt": "firstPublishedAt",
    "id": "id",
    "publishedAt": "publishedAt",
    "publishedBy": {
      "sys": {
        "id": "id",
        "linkType": "linkType",
        "type": "Link"
      }
    },
    "publishedCounter": 1,
    "publishedVersion": 1,
    "space": {
      "sys": {
        "id": "id",
        "linkType": "linkType",
        "type": "Link"
      }
    },
    "type": "DestinationFolderNode",
    "updatedAt": "updatedAt",
    "updatedBy": {
      "sys": {
        "id": "id",
        "linkType": "linkType",
        "type": "Link"
      }
    },
    "version": 1
  }
}

Updates a Destination Node by ID, or creates a new one with the specified ID if the Destination Node does not exist. Omit X-Contentful-Version to create; send the current version to update.

Include a top-level type field set to DestinationFolderNode, DestinationExperienceNode, or DestinationRedirectNode. Requests without type are rejected. Experience and redirect nodes can be saved as unassigned drafts, but require experience or redirectTo, respectively, before publishing.

Include parent when updating an existing node. Omit it only when creating a node at the Destination root.

To change between folder and experience nodes, send the target type, the current X-Contentful-Version, and a complete body preserving the existing parent and path. The node, its descendants, and any redirects targeting it must be unpublished. Success returns 200 OK with the same ID and sys.version reset to 1. Changes to or from redirect nodes are unsupported. See Changing a node’s type for requirements and client refresh behavior.

For property fields, path validation, and home nodes, see Node properties and paths.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

ID of the space.

environmentIdstringRequired

ID of the environment.

destinationIdstringRequired

ID of the Destination.

nodeIdstringRequired

ID of the Destination Node.

Request

This endpoint expects an object.

DestinationFolderNodeobjectRequired

Groups other Destination Nodes under a path without serving an experience.

DestinationExperienceNodeobjectRequired

Serves a published experience at a path.

DestinationRedirectNodeobjectRequired

Redirects to another Destination Node in the same Destination. The target can be unassigned while the node is a draft.

Response

OK - Destination Node updated

Destination Folder Nodeobject

Destination Experience Nodeobject

Destination Redirect Nodeobject

Authentication

Path parameters

Headers

Request

Response