Create blueprint

1 min

POST

/_cms/v1/blueprints

Create a new blueprint.

Header Parameters

Preferstring[]
Example
```
[
  "return=representation"
]
```
Description
Indicates client preference for the response content as per IETF RFC7240. Currently only supports 'return=representation' which can be used to indicate a preference to receive a representation of the resource that has been altered in the response.

Body Parameters

bodyBlueprintrequired
Description
The blueprint that should be created.
- keystring
  Description
  The unique identifier (key) of the resource.
- displayNamestringrequired
  Description
  The display name of this blueprint.
  Min Length
  1
  Max Length
  255
- contentTypestringrequired
  Description
  The content type of this blueprint.
  Min Length
  1
- contentBlueprintDatarequired
  Description
  Represents the data part of a Blueprint.
  - ContentData
    - bindingContentBinding
      Description
      Associates a content item with another source content item, establishing a relationship defined by a content type binding. Used for linking managed content to external or reference content.
      - contentTypeBindingstring
        Description
        The binding definition key that controls how the source content item is linked and accessed.
      - sourcestring<uri>required
        Description
        The reference to the source content item that is being bound. This cannot be empty.
        Format
        uri
    - propertiesmap<string, PropertyData>
      Description
      Properties as they are defined by corresponding component or content type.
  - object
    - compositionCompositionNode
      Description
      Specifies a node in a content composition.
      - idstring
        Description
        Specifies an identifier of this CompositionNode.
      - displayNamestring
        Description
        The display name of this ContentType.
        Max Length
        255
      - nodeTypestringrequired
        Description
        The node type of this CompositionNode.
        Min Length
        1
      - layoutTypestring
        Description
        The node layout type of this CompositionNode
      - displaySettingsCompositionDisplaySettings
        Description
        Defines display settings for a CompositionNode.
        displayTemplatestringrequired
        Description
        The display template that these settings apply to.
        Min Length
        1
        settingsmap<string, string>
        Description
        The display settings of this CompositionNode.
      - componentContentComponent
        Description
        Represents a content component.
        ContentData
        Circular-Reference
        object
        referencestring<uri>
        Description
        A reference to the content of this component. Cannot be assigned together with 'contentType' or 'properties'.
        Format
        uri
        contentTypestring
        Description
        The key of the content type that this is an embedded instance of.
      - nodesCompositionNode[]
        Description
        The child nodes for this CompositionNode.
        Circular-Reference

Responses

201Created

Blueprint
Description
Represents a blueprint of a content item.
- keystring
  Description
  The unique identifier (key) of the resource.
- displayNamestringrequired
  Description
  The display name of this blueprint.
  Min Length
  1
  Max Length
  255
- contentTypestringrequired
  Description
  The content type of this blueprint.
  Min Length
  1
- createdstring<date-time>
  Description
  A timestamp indicating when this resource was first created.
  Format
  date-time
- createdBystring
  Description
  The name of the user or application that created this resource.
- lastModifiedstring<date-time>
  Description
  Indicates the last time this resource was modified.
  Format
  date-time
- lastModifiedBystring
  Description
  The name of the user or application that last modified this resource.
- contentBlueprintDatarequired
  Description
  Represents the data part of a Blueprint.
  - ContentData
    - bindingContentBinding
      Description
      Associates a content item with another source content item, establishing a relationship defined by a content type binding. Used for linking managed content to external or reference content.
      - contentTypeBindingstring
        Description
        The binding definition key that controls how the source content item is linked and accessed.
      - sourcestring<uri>required
        Description
        The reference to the source content item that is being bound. This cannot be empty.
        Format
        uri
    - propertiesmap<string, PropertyData>
      Description
      Properties as they are defined by corresponding component or content type.
  - object
    - compositionCompositionNode
      Description
      Specifies a node in a content composition.
      - idstring
        Description
        Specifies an identifier of this CompositionNode.
      - displayNamestring
        Description
        The display name of this ContentType.
        Max Length
        255
      - nodeTypestringrequired
        Description
        The node type of this CompositionNode.
        Min Length
        1
      - layoutTypestring
        Description
        The node layout type of this CompositionNode
      - displaySettingsCompositionDisplaySettings
        Description
        Defines display settings for a CompositionNode.
        displayTemplatestringrequired
        Description
        The display template that these settings apply to.
        Min Length
        1
        settingsmap<string, string>
        Description
        The display settings of this CompositionNode.
      - componentContentComponent
        Description
        Represents a content component.
        ContentData
        Circular-Reference
        object
        referencestring<uri>
        Description
        A reference to the content of this component. Cannot be assigned together with 'contentType' or 'properties'.
        Format
        uri
        contentTypestring
        Description
        The key of the content type that this is an embedded instance of.
      - nodesCompositionNode[]
        Description
        The child nodes for this CompositionNode.
        Circular-Reference

Response Headers

ETagstring
Description
The RFC7232 ETag header field in a response provides the current entity-tag for the resource. An entity-tag is an opaque identifier for different versions of a resource over time, regardless whether multiple versions are valid at the same time.
Last-Modifiedstring<http-date>
Description
The date and time at which the resource was last modified.
Format
http-date
Locationstring
Description
Indicates the URL of the newly-created resource.
Preference-Applied

400Bad Request

401Unauthorized

403Forbidden

409Conflict

500Internal Server Error

curl

curl --request POST \
     --url /_cms/v1/blueprints \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "displayName": "",
     "contentType": "",
     "content": {
     "binding": {
     "source": ""
     },
     "composition": {
     "nodeType": "",
     "displaySettings": {
     "displayTemplate": ""
     },
     "component": {}
     }
     }
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "displayName": "",
   "contentType": "",
   "content": {
      "binding": {
         "source": ""
      },
      "composition": {
         "nodeType": "",
         "displaySettings": {
            "displayTemplate": ""
         },
         "component": {}
      }
   }
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("/_cms/v1/blueprints", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("/_cms/v1/blueprints")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "displayName": "",
   "contentType": "",
   "content": {
      "binding": {
         "source": ""
      },
      "composition": {
         "nodeType": "",
         "displaySettings": {
            "displayTemplate": ""
         },
         "component": {}
      }
   }
})

response = http.request(request)
puts response.read_body

python

import requests
import json

url = "/_cms/v1/blueprints"

payload = json.dumps({
   "displayName": "",
   "contentType": "",
   "content": {
      "binding": {
         "source": ""
      },
      "composition": {
         "nodeType": "",
         "displaySettings": {
            "displayTemplate": ""
         },
         "component": {}
      }
   }
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

201

// Created
{
  "key": "",
  "displayName": "",
  "contentType": "",
  "created": "",
  "createdBy": "",
  "lastModified": "",
  "lastModifiedBy": "",
  "content": {}
}

400

// Bad Request

401

// Unauthorized

403

// Forbidden

409

// Conflict

500

// Internal Server Error