Read a Type
get
/content/management/api/v1.1/types/{name}
Read a type.
Request
Path Parameters
-
name: string
Type name identifier is case-sensitive and any special characters must be encoded
Query Parameters
-
expand(optional): string
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. -
fields(optional): string
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
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 -
links(optional): string
This parameter accepts a comma-separated list of link names. By default, this parameter gives all the links applicable. Possible values are: self, canonical, describedby
Response
Supported Media Types
- application/json
200 Response
OK.
Root Schema : Type
Type:
objectAggregatedType
Show Source
-
allowedActions(optional):
array allowedActions
allowedActions on Type.
-
allowedFileTypes(optional):
array allowedFileTypes
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 .
-
apiName(optional):
string
API Name of the type.
-
archivedFields(optional):
object ItemSubResourceListTypeField
Item SubResource.
-
connectorInfos(optional):
array connectorInfos
connectorInfos on Type.
-
createdBy(optional):
string
Created by
-
createdDate(optional):
object date
date
-
description(optional):
string
Description of the type.
-
displayName(optional):
string
display name of the type. It is a required property in the get response whereas it is not required in the post/put request.
-
fields(optional):
array fields
Fields used in the type.
-
id(optional):
string
id of the type. It is a required property in the get response and put request whereas it is not required in the post request.
-
inplacePreview(optional):
object ItemSubResourceListInplacePreview
Item SubResource.
-
jobToken(optional):
string
job token of the background job updating the Type.
-
layoutMapping(optional):
object ItemSubResourceListLayoutMapping
Item SubResource.
-
links(optional):
array links
-
name(optional):
string
Name of the type. It is a required property in the get response and post/put request.
-
properties(optional):
object properties
Additional Properties Allowed: additionalPropertiesType specific properties.
-
relationships(optional):
object ItemSubResourceTypeRelationships
Item SubResource.
-
requiredTaxonomies(optional):
object ItemSubResourceListRequiredTaxonomy
Item SubResource.
-
roleName(optional):
string
Name of the user's role on the content type.
-
typeCategory(optional):
string
Category of the type. The allowed values are [ContentType, DigitalAssetType]. It is a required property in the get response. It is optional in post request and defaults to ContentType. It is also optional in put request and is identified based on the typeName path param in URL.
-
updatedBy(optional):
string
Updated by
-
updatedDate(optional):
object date
date
Nested Schema : allowedActions
Type:
arrayallowedActions on Type.
Show Source
-
Array of:
string
Allowed Values:
[ "preview", "read", "write", "update", "delete" ]
Nested Schema : allowedFileTypes
Type:
arrayAllowed 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 : connectorInfos
Type:
arrayconnectorInfos on Type.
Show Source
-
Array of:
object ConnectorInfo
ConnectorInfo
Nested Schema : fields
Type:
arrayFields used in the type.
Show Source
-
Array of:
object TypeField
FieldInAggrType.
Nested Schema : properties
Type:
objectAdditional Properties Allowed
Show Source
Type specific properties.
Nested Schema : TypeField
Type:
objectFieldInAggrType.
Show Source
-
apiName(optional):
string
API Name of the field.
-
archivedBy(optional):
string
Archived by.
-
archivedDate(optional):
object date
date
-
datatype(optional):
string
Allowed Values:
[ "number", "long", "decimal", "text", "largetext", "reference", "datetime", "boolean" ]Data Type Enum. It is a required property in the get response and post/put request. -
defaultValue(optional):
object defaultValue
defaultValue for field.
-
description(optional):
string
Description of the field.
-
id(optional):
string
id of the field. It is a required property in the get response and put request whereas it is not required in the post request.
-
isSystemField(optional):
boolean
Is the field provided by the system.
-
name(optional):
string
name of the field. It is a required property in the get response and post/put request.
-
properties(optional):
object properties
Additional Properties Allowed: additionalPropertiesField specific properties. The field publishingDependency is specific for media and reference.
-
required(optional):
boolean
Required or optional value for the Field. It is a required property in the get response and post/put request.
-
settings(optional):
object settings
Additional Properties Allowed: additionalPropertiesField specific settings.
-
valuecount(optional):
string
Allowed Values:
[ "single", "list" ]Value count as a single or list. It is a required property in the get response and post/put request.
Nested Schema : defaultValue
Type:
objectdefaultValue for field.
Nested Schema : properties
Type:
objectAdditional 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:
objectAdditional Properties Allowed
Show Source
Field specific settings.
Nested Schema : additionalProperties
Type:
objectNested Schema : additionalProperties
Type:
objectNested Schema : Link
Type:
objectLink of the resource.
Show Source
-
href(optional):
string
The target resource's URI. It could be template URI. It is a required property in the get response.
-
mediaType(optional):
string
Media type.
-
method(optional):
string
What HTTP method can be used to access the target resource.
-
profile(optional):
string
Link to the metadata that describes the target resource.
-
rel(optional):
string
Relation type. It is a required property in the get response.
-
templated(optional):
boolean
Whether the URI is a template.
Nested Schema : ConnectorInfo
Type:
objectConnectorInfo
Show Source
-
connectorId(optional):
string
id of the connector.
-
connectorSyncEnabled(optional):
boolean
Sync status of connector.
Nested Schema : LayoutMapping
Type:
objectLayoutMapping
Show Source
-
apiName(optional):
string
Name of the layout.
-
formats(optional):
object formats
Additional Properties Allowed: additionalPropertieslayout formats.
-
generateRendition(optional):
boolean
generateRendition.
-
id(optional):
integer(int64)
Id of the layout mapping.
-
label(optional):
string
Name of the category for layout mapping.
Nested Schema : additionalProperties
Type:
objectNested Schema : TypeRelationships
Type:
objectType Relationships
Show Source
-
references(optional):
array references
Unique Items Required:
trueReference type names/ids
Nested Schema : references
Type:
arrayUnique Items Required:
trueReference type names/ids
Show Source
-
Array of:
object TypeReferences
Type References bean
Nested Schema : TypeReferences
Type:
objectType References bean
Show Source
-
id(optional):
string
id of the type
-
links(optional):
array links
-
name(optional):
string
name of the type
Nested Schema : RequiredTaxonomy
Type:
Show Source
object-
defaultCategories(optional):
array defaultCategories
-
description(optional):
string
Read Only:
true -
id(optional):
string
-
name(optional):
string
Read Only:
true
Nested Schema : Category
Type:
Show Source
object-
apiName(optional):
string
Read Only:
true -
id(optional):
string
-
name(optional):
string
Read Only:
true
304 Response
Not modified.
400 Response
Bad request.
403 Response
Forbidden.
404 Response
Not found.
500 Response
Internal server error.
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"
}
]
}
}
]
}