Create a new Destination Node

POST

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

POST

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

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

201Created

{
  "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
  }
}

Creates a Destination Node and returns it with a generated ID. 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. Assign experience to an experience node or redirectTo to a redirect node before publishing it.

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.

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

Created - Destination Node created

Destination Folder Nodeobject

Destination Experience Nodeobject

Destination Redirect Nodeobject