v1

latestOpenAPI 3.0.02026-07-2417611.8 MB
Authoring types

Retrieve an existing element definition.

Use the /elementdefs/{id} end-point to retrieve an existing element definition from the database.

Each element definition describes a variety of element that can be added to a content type.

To programmatically create a content-type, merge the 'elementFragment' attribute into the 'elements' attribute of the type, performing the following replacements: '$ELEMENT_KEY$': With the desired element key '$ELEMENT_LABEL$': With the desired element label <br />User roles: admin, manager, editor, viewer

get/authoring/v1/elementdefs/{id}

Path parameters

idstring required

Provide the ID of the element definition that you want to retrieve.

Query parameters

fieldsstring

Only the element definition fields that are specified here are returned for each result. Any element definition field is a valid value and can be specified as a comma-separated list.

includestring

Specify additional fields to include with each result. Valid options are:

  • links: Adds the 'links' section (see '#/definitions/DocumentLinks') to the response.
  • all: Adds all current and future additional fields to the response.

When used in-conjunction with the 'fields' option, both the fields that are specified in the 'fields' option and the fields in the 'include' option are returned.

Headers

If-None-Matchstring

Provide an Etag value from a previous request to check whether the element definition retrieved is the most recent version. If the element definition is the most recent version, the call returns a 304 ( Not modified) message instead of sending the element definition back.

Response

Successfully retrieved the element definition that matches the ID provided from the database.

idstring

The ID of the element definition.

revstring

The current revision of the element definition.

namestring

The name of the element definition.

descriptionstring

The description of the element definition.

classification'element-definition'

the element definition classification.

creatorIdstring
createdstring date-time

The created date of this element definition in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. This field is read only.

lastModifierIdstring
lastModifiedstring date-time

The last modified date of this element definition in ISO 8601 with the format YYYY-MM-DDThh:mm:ss.sssZ. This field is read only.

tagsstring[]
status'draft' | 'ready' | 'retired'

the workflow status.