Read a Type

get

/content/management/api/v1.1/types/{name}

Read a type.

Request

Path Parameters
  • Type name identifier is case-sensitive and any special characters must be encoded
Query Parameters
  • Expand parameter provides the option of getting child resources (archivedFields) inline with the type's response. Accepts archivedFields, relationships or all.
    Example : expand=all
    Returns archivedFields and relationships in the type response.
    Example : expand=archivedFields
    Returns archivedFields in the type response.
  • This parameter is used to control the returned fields for a type. This parameter accepts a comma-separated list of field names.
    All the field names are case-sensitive therefore users must provide the correct field names in the query.
    If this parameter is not supplied, the response will contain the default fields.

    The default fields are:
    • id
    • name
    • displayName
    • apiName
    • description
    • typeCategory
    • createdBy
    • createdDate
    • updatedBy
    • updatedDate
    • fields
    • properties
    • allowedFileTypes
    • roleName
    • layoutMapping
    • inplacePreview
    • allowedActions
    • archivedFields
    • relationships
    • connectorInfos
    Users can select any field to be returned. Any incorrect or invalid field name given in the query will result in an error.

    Example: ?fields=name
    This will return only the name and links of the type.
    Default Value: id,name,displayName,apiName,description,typeCategory,createdBy,createdDate,updatedBy,updatedDate,fields,properties,allowedFileTypes,roleName,layoutMapping,inplacePreview,allowedActions,archivedFields,relationships,connectorInfos,jobToken,renditionPolicies
Back to Top

Response

Supported Media Types

200 Response

OK.
Body ()
Root Schema : Type
Type: object
AggregatedType
Show Source
Nested Schema : allowedActions
Type: array
allowedActions on Type.
Show Source
  • Allowed Values: [ "preview", "read", "write", "update", "delete" ]
Nested Schema : allowedFileTypes
Type: array
Allowed list of file extensions supported by the type. It is a required property in the get response. It is optional in post/put request and defaults to [ContentItem] if the typeCategory is ContentType and defaults to empty if the typeCategory is DigitalAssetType .
Show Source
Nested Schema : ItemSubResourceListTypeField
Type: object
Item SubResource.
Show Source
Nested Schema : connectorInfos
Type: array
connectorInfos on Type.
Show Source
Nested Schema : date
Type: object
date
Show Source
Nested Schema : fields
Type: array
Fields used in the type.
Show Source
Nested Schema : ItemSubResourceListInplacePreview
Type: object
Item SubResource.
Show Source
Nested Schema : ItemSubResourceListLayoutMapping
Type: object
Item SubResource.
Show Source
Nested Schema : properties
Type: object
Additional Properties Allowed
Show Source
Type specific properties.
Nested Schema : ItemSubResourceTypeRelationships
Type: object
Item SubResource.
Show Source
Nested Schema : ItemSubResourceListRequiredTaxonomy
Type: object
Item SubResource.
Show Source
Nested Schema : data
Type: array
Show Source
Nested Schema : TypeField
Type: object
FieldInAggrType.
Show Source
Nested Schema : defaultValue
Type: object
defaultValue for field.
Nested Schema : properties
Type: object
Additional Properties Allowed
Show Source
Field specific properties. The field publishingDependency is specific for media and reference.
Example:
{caas-translation: {inheritFromMaster: false}, publishingDependency: optional}
Nested Schema : settings
Type: object
Additional Properties Allowed
Show Source
Field specific settings.
Nested Schema : additionalProperties
Type: object
Nested Schema : additionalProperties
Type: object
Nested Schema : ConnectorInfo
Type: object
ConnectorInfo
Show Source
Nested Schema : data
Type: array
Show Source
Nested Schema : InplacePreview
Type: object
InplacePreview
Show Source
Nested Schema : data
Type: array
Show Source
Nested Schema : LayoutMapping
Type: object
LayoutMapping
Show Source
Nested Schema : formats
Type: object
Additional Properties Allowed
Show Source
layout formats.
Nested Schema : additionalProperties
Type: object
Nested Schema : TypeRelationships
Type: object
Type Relationships
Show Source
Nested Schema : references
Type: array
Unique Items Required: true
Reference type names/ids
Show Source
Nested Schema : TypeReferences
Type: object
Type References bean
Show Source
Nested Schema : data
Type: array
Show Source
Nested Schema : RequiredTaxonomy
Type: object
Show Source
Nested Schema : defaultCategories
Type: array
Show Source
Nested Schema : Category
Type: object
Show Source

304 Response

Not modified.

400 Response

Bad request.

403 Response

Forbidden.

404 Response

Not found.

500 Response

Internal server error.
Back to Top

Examples

The following example shows how to get all the types by submission of a GET request using cURL.

curl -X GET -H 'Accept: application/json' 'https://host:port/content/management/api/v1.1/types/{name}'

Example 1

This reads a type with name:TypeSample.

/content/management/api/v1.1/types/TypeSample

Response Body

{
        "id": "D103EEB2A5CC42619D7688A62A169092",
        "name": "TypeSample",
        "displayName": "TypeSampleDisplayName",
        "apiName": "typeSample",
        "typeCategory" : "ContentType",
        "allowedFileTypes" : ["ContentItem"],
        "description": "",
        "createdBy": "cecusername",
        "createdDate": {
          "value": "2018-11-23T10:33:17.270Z",
          "timezone": "UTC"
        },
        "updatedBy": "cecusername",
        "updatedDate": {
          "value": "2018-11-23T10:33:17.270Z",
          "timezone": "UTC"
        },
        "fields": [
          {
            "id": "66EA1FD6AE634B1290968AB1C8F606C4",
            "name": "fieldASample",
            "apiName": "fieldASample",
            "description": "Content",
            "datatype": "largetext",
            "required": false,
            "valuecount": "single",
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
            "name": "fieldBSample",
            "apiName": "fieldBSample",
            "description": "Content",
            "datatype": "largetext",
            "required": true,
            "valuecount": "single",
            "properties": {},
            "settings": {}
          }
        ],
        "jobToken":"OPC3630DF06AC04F4EB477A62B0EFB47",
        "properties": {},
        "properties": {
          "caas-translations": {
            "description": {
              "inheritFromMaster": false,
              "note": "",
              "translate": true
            },
            "file": {
              "inheritFromMaster": true,
              "note": "",
              "translate": false
            },
            "name": {
              "inheritFromMaster": false,
              "note": "",
              "translate": true
            },
            "slug": {
              "inheritFromMaster": false,
              "note": "",
              "translate": true
            }
          }
        },
        "roleName": "manager",
        "archivedFields": {
          "links": [
            {
              "href": "http://<hostname>/content/management/api/v1.1/types/TypeSample/archivedFields",
              "rel": "self",
              "method": "GET",
              "mediaType": "application/json"
            }
          ]
        },
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/types/TypeSample",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/management/api/v1.1/types/TypeSample",
            "rel": "canonical",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/TypeSample",
            "rel": "describedby",
            "method": "GET",
            "mediaType": "application/schema+json"
          }
        ]
      }    

Example 2

This reads a type with name:TypeSample along with archivedFields. archivedFields can also be replaced with 'all'.

/content/management/api/v1.1/types/TypeSample?expand=archivedFields

Response Body

{
        "id": "D103EEB2A5CC42619D7688A62A169092",
        "name": "TypeSample",
        "apiName": "typeSample",
        "description": "",
        "typeCategory" : "ContentType",
        "allowedFileTypes" : ["ContentItem"],
        "createdBy": "cecusername",
        "createdDate": {
          "value": "2018-11-23T10:33:17.270Z",
          "timezone": "UTC"
        },
        "updatedBy": "cecusername",
        "updatedDate": {
          "value": "2018-11-23T10:33:17.270Z",
          "timezone": "UTC"
        },
        "fields": [
          {
            "id": "66EA1FD6AE634B1290968AB1C8F606C4",
            "name": "fieldASample",
            "apiName": "fieldASample",
            "description": "Content",
            "datatype": "largetext",
            "required": false,
            "valuecount": "single",
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
            "name": "fieldBSample",
            "apiName": "fieldBSample",
            "description": "Content",
            "datatype": "largetext",
            "required": true,
            "valuecount": "single",
            "properties": {},
            "settings": {}
          }
        ],
        "properties": {},
        "roleName": "manager",
        "archivedFields": {
          "data": [
            {
              "id": "2383782175B04C7AB62F25E7A606196E",
              "name": "Test139004168217008",
              "description": "Test139004168251009",
              "datatype": "text",
              "required": false,
              "valuecount": "list",
              "properties": {},
              "settings": {},
              "archivedBy": "cecusername",
              "archivedDate": {
                "value": "2020-05-01T08:33:11.943Z",
                "timezone": "UTC"
              }
            },
            {
              "id": "0502F305EDD74CED87CF7ADA4F07D7F8",
              "name": "Test139004168280000",
              "description": "Test139004168295001",
              "datatype": "largetext",
              "required": false,
              "valuecount": "single",
              "properties": {},
              "settings": {},
              "archivedBy": "cecusername",
              "archivedDate": {
                "value": "2020-05-01T08:33:11.947Z",
                "timezone": "UTC"
              }
            }
          ],
          "links": [
            {
              "href": "http://<hostname>/content/management/api/v1.1/types/TypeSample/archivedFields",
              "rel": "self",
              "method": "GET",
              "mediaType": "application/json"
            }
          ]
        },
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/types/TypeSample?expand=archivedFields",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/management/api/v1.1/types/TypeSample?expand=archivedFields",
            "rel": "canonical",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/TypeSample",
            "rel": "describedby",
            "method": "GET",
            "mediaType": "application/schema+json"
          }
        ]
      }    

Example 3

This reads a type with name:DigitalTypeSample.

/content/management/api/v1.1/types/DigitalTypeSample

Response Body

{
        "id": "D103EEB2A5CC42619D7688A62A169092",
        "name": "TypeSample",
        "typeCategory" : "DigitalAssetType",
        "allowedFileTypes" : ["jpg","jpeg","png"],
        "description": "",
        "createdBy": "cecusername",
        "createdDate": {
          "value": "2018-11-23T10:33:17.270Z",
          "timezone": "UTC"
        },
        "updatedBy": "cecusername",
        "updatedDate": {
          "value": "2018-11-23T10:33:17.270Z",
          "timezone": "UTC"
        },
        "fields": [
          {
            "id": "66EA1FD6AE634B1290968AB1C8F606C4",
            "name": "fieldASample",
            "description": "Content",
            "datatype": "largetext",
            "required": false,
            "valuecount": "single",
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
            "name": "fieldBSample",
            "description": "Content",
            "datatype": "largetext",
            "required": true,
            "valuecount": "single",
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
            "name": "size",
            "description": "size",
            "datatype": "number",
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE3",
            "name": "fileType",
            "description": "fileType",
            "datatype": "text",
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE9",
            "name": "fileGroup",
            "description": "fileGroup",
            "datatype": "text",
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE5",
            "name": "mimeType",
            "description": "mimeType",
            "datatype": "text",
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE6",
            "name": "renditions",
            "description": "renditions",
            "datatype": "json",
            "jsonSchema" : null,
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE7",
            "name": "metadata",
            "description": "metadata",
            "datatype": "json",
            "jsonSchema" : null,
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE8",
            "name": "native",
            "description": "native",
            "datatype": "json",
            "jsonSchema" : null,
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DA8",
            "name": "advancedVideoInfo",
            "description": "advancedVideoInfo",
            "datatype": "json",
            "jsonSchema" : null,
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          }
        ],
        "properties": {},
        "roleName": "manager",
        "archivedFields": {
          "links": [
            {
              "href": "http://<hostname>/content/management/api/v1.1/types/DigitalTypeSample/archivedFields",
              "rel": "self",
              "method": "GET",
              "mediaType": "application/json"
            }
          ]
        },
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/types/DigitalTypeSample",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/management/api/v1.1/types/DigitalTypeSample",
            "rel": "canonical",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/DigitalTypeSample",
            "rel": "describedby",
            "method": "GET",
            "mediaType": "application/schema+json"
          }
        ]
      }    

Example 4

This reads a type with name:DigitalTypeSample along with archivedFields. archivedFields can also be replaced with 'all'.

/content/management/api/v1.1/types/DigitalTypeSample

Response Body

{
        "id": "D103EEB2A5CC42619D7688A62A169092",
        "name": "DigitalTypeSample",
        "description": "",
        "typeCategory" : "DigitalAssetType",
        "allowedFileTypes" : ["jpg","jpeg","png"],
        "createdBy": "cecusername",
        "createdDate": {
          "value": "2018-11-23T10:33:17.270Z",
          "timezone": "UTC"
        },
        "updatedBy": "cecusername",
        "updatedDate": {
          "value": "2018-11-23T10:33:17.270Z",
          "timezone": "UTC"
        },
        "fields": [
          {
            "id": "66EA1FD6AE634B1290968AB1C8F606C4",
            "name": "fieldASample",
            "description": "Content",
            "datatype": "largetext",
            "required": false,
            "valuecount": "single",
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
            "name": "fieldBSample",
            "description": "Content",
            "datatype": "largetext",
            "required": true,
            "valuecount": "single",
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE2",
            "name": "size",
            "description": "size",
            "datatype": "number",
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE3",
            "name": "fileType",
            "description": "fileType",
            "datatype": "text",
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE9",
            "name": "fileGroup",
            "description": "fileGroup",
            "datatype": "text",
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE5",
            "name": "mimeType",
            "description": "mimeType",
            "datatype": "text",
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE6",
            "name": "renditions",
            "description": "renditions",
            "datatype": "json",
            "jsonSchema" : null,
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE7",
            "name": "metadata",
            "description": "metadata",
            "datatype": "json",
            "jsonSchema" : null,
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DE8",
            "name": "native",
            "description": "native",
            "datatype": "json",
            "jsonSchema" : null,
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          },
          {
            "id": "B4E2EA0BBD5E4DD38BA721BEA7E02DA8",
            "name": "advancedVideoInfo",
            "description": "advancedVideoInfo",
            "datatype": "json",
            "jsonSchema" : null,
            "required": false,
            "valuecount": "single",
            "isSystemField":true,
            "properties": {},
            "settings": {}
          }
        ],
        "properties": {},
        "roleName": "manager",
        "archivedFields": {
          "data": [
            {
              "id": "2383782175B04C7AB62F25E7A606196E",
              "name": "Test139004168217008",
              "description": "Test139004168251009",
              "datatype": "text",
              "required": false,
              "valuecount": "list",
              "properties": {},
              "settings": {},
              "archivedBy": "cecusername",
              "archivedDate": {
                "value": "2020-05-01T08:33:11.943Z",
                "timezone": "UTC"
              }
            },
            {
              "id": "0502F305EDD74CED87CF7ADA4F07D7F8",
              "name": "Test139004168280000",
              "description": "Test139004168295001",
              "datatype": "largetext",
              "required": false,
              "valuecount": "single",
              "properties": {},
              "settings": {},
              "archivedBy": "cecusername",
              "archivedDate": {
                "value": "2020-05-01T08:33:11.947Z",
                "timezone": "UTC"
              }
            }
          ],
          "links": [
            {
              "href": "http://<hostname>/content/management/api/v1.1/types/DigitalTypeSample/archivedFields",
              "rel": "self",
              "method": "GET",
              "mediaType": "application/json"
            }
          ]
        },
        "links": [
          {
            "href": "https://<hostname>/content/management/api/v1.1/types/DigitalTypeSample?expand=archivedFields",
            "rel": "self",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/management/api/v1.1/types/DigitalTypeSample?expand=archivedFields",
            "rel": "canonical",
            "method": "GET",
            "mediaType": "application/json"
          },
          {
            "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/DigitalTypeSample",
            "rel": "describedby",
            "method": "GET",
            "mediaType": "application/schema+json"
          }
        ]
      }
    }
  ]
}  
Back to Top