--- title: "Create content items." method: POST path: "/authoring/v1/content" tags: ["Authoring content"] --- # Create content items. `POST /authoring/v1/content` Use the /content endpoint to create content. A content type must be specified through the typeId property. You cannot create content without a content type. ### Example: ### Creates a readied content that contains the name and birthday of a person. # ~~~ { "name": "Person", "typeId": "b0798e67-3da2-48b4-b044-016495fa3ead", "status": "ready", "elements": { "name": { "elementType": "text", "value": "Thomas Watson" }, "birthday": { "elementType": "datetime", "value": "1874-02-17T00:00:00Z" } } } ~~~
User roles: admin, manager, editor ## Headers - `x-ibm-dx-publish-priority` 'now' | 'next', string ## Request body - object - `name` string, required — The name of the content item. - `typeId` string, required — The ID of the content type this content item is based on. - `elements` object — Elements are defined in the content type. A content type for a content is referenced through the typeId attribute. The elements in the content are based on the content type that is referenced. A content can have multiple elements such as text, number, video, images. For example, to include a text element include \"someTextElement\":{\"elementType\": \"text\", \"value\": \"some text goes here\" }. For a complete list of content elements, see https://developer.goacoustic.com/acoustic-content/reference#authoring-content - `isSystem` boolean — Indicates whether this item is a 'system item' or not. 'System item' means that this is an item managed internally by Acoustic. - `libraryId` string — If this property is set it points to library id that the item is assigned to. ## Response `201` Successfully created a content item with the specified content type. - object - `id` string — The ID of the content item. - `rev` string — The current revision of the document. - `name` string — The name of the content item. - `description` string — The description of the content item. - `typeId` string — The ID of the content type this item belongs to. - `type` string — The name of the content type this item belongs to. Only included when using include=metadata - `kind` string — The kind of the content. Recognized values are "site", "page", "landing-page", "email" - `lastModified` string, date-time — The last modified date of this content item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ. This field is read only. - `lastModifierId` string — The ID of the user that last modified the content. - `lastModifier` string — The display name of the user that last modified the content. - `created` string, date-time — The created date of this content item in ISO 8601 with the format YYYY-MM-DDTHH:mm:ss.sssZ. This field is read only. - `creatorId` string — The ID of the creator of the content. - `creator` string — The display name of the user that created the content. - `classification` 'content' — The classification defines the document type. For content items, all documents are classified as "content". - `status` 'draft' | 'ready' | 'retired' — the workflow status of the content. - `linkedDocId` string — Provided on drafts of existing items. This is the ID of the primary item. - `elements` object — The elements section is dependent on the content type of this content. (Referenced via the typeId attribute) with Elements are defined in the content type and therefore the elements section is dependent on the content type of this content. The content type is referenced through the typeId attribute. A content can have multiple elements such as text, number, video, images etc. For a complete list of content elements see, https://developer.goacoustic.com/acoustic-content/reference#authoring-content - `tags` string[] — The tags describing the content item. - `links` object - `self` object — The default link back to this document - `href` string - `linkedDoc` object — This link will appear if this item is a draft of an existing item. The link points to the primary item - `href` string - `draft` object — This link will appear on an item if there exists a draft of this item. The link points to the draft. - `href` string - `create-draft` object — This link will appear for items in ready and retired state that don't already have an existing draft. It will create a draft of this item. - `href` string - `ready` object — This link will appear for items that can be transitioned to the ready state. - `href` string - `retire` object — This link will appear for items that can be transitioned to the retired state. - `href` string - `type` object — This is the link to the content's type. - `href` string - `thumbnail` object — The reference to the resource that should act as the thumbnail of this content item. The thumbnail can be referred to by either id or path. This field is read only, and is determined by the contentThumbnail field on the content type. The type can specify an image element on this content item, or a specific image resource. - `id` string — The ID of the asset. - `path` string — The path of the resource. - `url` string — The url of the resource. - `isSystem` boolean — Indicates whether this item is a 'system item' or not. 'System item' means that this is an item managed internally by Acoustic. - `libraryId` string — If this property is set it points to library id that the item is assigned to. ## Other responses - `400` — The body parameter is empty or has an invalid input. Provide valid type fields that are required to create the new content item. - `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time. - `503` — Unable to create the content item as the service is unavailable. Try again later. - `default` — Unexpected error. --- [API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/versions/677305266d89/schema)