Read Type Update Operations Status
get
/content/management/api/v1.1/types/{name}/updateType/.status/{statusId}
Read Type Update Operations status.
Request
Path Parameters
-
name: string
Type name identifier is case-sensitive and any special characters must be encoded
-
statusId: string
status id of the type update operations.
Query Parameters
-
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 : TypeUpdateOperationJobStatus
Type:
object
TypeUpdateOperationJobStatus
Show Source
-
completed(optional):
boolean
Whether the original request is completed or not
-
completedPercentage(optional):
integer(int32)
A number between 0 and 100, capturing how much of the process has been completed.
-
endTime(optional):
object date
date
-
error(optional):
object Error
Error
-
id(optional):
string
status id of the original request. It is a required property in the get response.
-
links(optional):
array links
links of the status resource
-
message(optional):
string
Human readable message about the current processing status
-
progress(optional):
string
Allowed Values:
[ "succeeded", "failed", "processing", "pending", "aborted", "paused", "blocked" ]
The current progress of the original request. It is a required property in the get response. -
requestStatus(optional):
integer(int32)
HTTP status code of the original request. This is not the polling request's status. Value is available only after the request is completed
-
result(optional):
object ResultType
Result
-
startTime(optional):
object date
date
Nested Schema : Error
Type:
object
Error
Show Source
-
detail(optional):
string
Detailed error message.
-
instance(optional):
string
URI to the link that provides more detail about the error.
-
o:errorCode(optional):
string
Application specific error code.
-
o:errorDetails(optional):
object Error
Error
-
o:errorPath(optional):
string
XPath or JSON patch to indicate where the error occurs.
-
status(optional):
integer(int32)
HTTP status code.
-
title(optional):
string
Summary error message. It is a required property in the get response.
-
type(optional):
string
Link to HTTP error code page. It is a required property in the get response.
Nested Schema : links
Type:
array
links of the status resource
Show Source
-
Array of:
object Link
Link of the resource.
Nested Schema : ResultType
Type:
object
Result
Show Source
-
body(optional):
object Type
AggregatedType
-
headers(optional):
array headers
List of the HTTP headers of the response to the original async request
-
status(optional):
object ResultHTTPStatus
ResultHTTPStatus
Nested Schema : Link
Type:
object
Link 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 : Type
Type:
object
AggregatedType
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 : headers
Type:
array
List of the HTTP headers of the response to the original async request
Show Source
-
Array of:
object ResultHTTPHeader
ResultHTTPHeader
Nested Schema : ResultHTTPStatus
Type:
object
ResultHTTPStatus
Show Source
-
code(optional):
integer(int32)
HTTP response status code
-
reason(optional):
string
HTTP response reason phrase
Nested Schema : allowedActions
Type:
array
allowedActions on Type.
Show Source
-
Array of:
string
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 : connectorInfos
Type:
array
connectorInfos on Type.
Show Source
-
Array of:
object ConnectorInfo
ConnectorInfo
Nested Schema : fields
Type:
array
Fields used in the type.
Show Source
-
Array of:
object TypeField
FieldInAggrType.
Nested Schema : properties
Type:
object
Additional Properties Allowed
Show Source
Type specific properties.
Nested Schema : TypeField
Type:
object
FieldInAggrType.
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:
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
-
connectorId(optional):
string
id of the connector.
-
connectorSyncEnabled(optional):
boolean
Sync status of connector.
Nested Schema : LayoutMapping
Type:
object
LayoutMapping
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:
object
Nested Schema : TypeRelationships
Type:
object
Type Relationships
Show Source
-
references(optional):
array references
Unique Items Required:
true
Reference type names/ids
Nested Schema : references
Type:
array
Unique Items Required:
true
Reference type names/ids
Show Source
-
Array of:
object TypeReferences
Type References bean
Nested Schema : TypeReferences
Type:
object
Type 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
Nested Schema : ResultHTTPHeader
Type:
object
ResultHTTPHeader
Show Source
-
name(optional):
string
HTTP response header name
-
value(optional):
string
HTTP response header value
304 Response
Not modified.
400 Response
Bad request.
403 Response
Forbidden.
404 Response
Not found.
409 Response
Conflict.
500 Response
Internal server error.
Examples
The following example shows how to read status of a type update operation 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}/updateType/.status/{statusId}'
Example 1
This reads status of a successful type update operation for given {typename}
with operation id: OP4C2BA99B626B4E43A4A64853D639F4CA.
/content/management/api/v1.1/types/{typename}/updateType/.status/OP4C2BA99B626B4E43A4A64853D639F4CA
Response Body
{ "id": "OPE0ED029409F14E2FA6BE244D7BE0C1E9", "startTime": { "value": "2020-04-25T00:08:55.712Z", "timezone": "UTC" }, "endTime": { "value": "2020-04-25T00:08:56.264Z", "timezone": "UTC" }, "progress": "succeeded", "completed": true, "message": "Job Completed Successfully", "completedPercentage": 100, "result": { "status": { "code": 200, "reason": "" }, "headers": [], "body": { "id": "698DADAFDD0841F38DD9FE9A4D38DA8C", "name": "Type1", "description": "", "typeCategory": "ContentType", "createdBy": "swebcli.SitesAdmin1.admin", "createdDate": { "value": "2020-04-22T03:01:59.188Z", "timezone": "UTC" }, "updatedBy": "swebcli.SitesAdmin1.admin", "updatedDate": { "value": "2020-04-25T00:08:56.023Z", "timezone": "UTC" }, "fields": [ { "id": "15560059AEB7487D95FDDB610EE03EE3", "name": "field1", "description": "field1", "datatype": "text", "required": true, "valuecount": "single", "defaultValue": "This is the default value for the field1", "properties": { "caas-translation": { "note": "", "translate": true } }, "settings": { "groupIndex": 0, "caas": { "description": "", "valuecountRange": null, "customValidators": [], "editor": { "name": "textbox", "options": {} } } } }, { "id": "E70C7D179A8A4A6F9C920C4F14177AA7", "name": "field2", "description": "field2", "datatype": "text", "required": false, "valuecount": "single", "properties": { "caas-translation": { "note": "", "translate": false } }, "settings": { "groupIndex": 0, "caas": { "description": "", "valuecountRange": null, "customValidators": [], "editor": { "name": "textbox", "options": {} } } } }, { "id": "2B63F14BDCE54C768AED77C92EAF82D4", "name": "field3", "description": "field3", "datatype": "text", "required": true, "valuecount": "single", "properties": { "caas-translation": { "inheritFromMaster": true, "note": "", "translate": false } }, "settings": { "groupIndex": 0, "caas": { "description": "", "valuecountRange": null, "customValidators": [], "editor": { "name": "textbox", "options": {} } } } }, { "id": "7353DFA594B64A80A5527F7765032F74", "name": "field4", "description": "field4", "datatype": "text", "required": false, "valuecount": "single", "properties": { "caas-translation": { "inheritFromMaster": true, "note": "", "translate": false } }, "settings": { "groupIndex": 0, "caas": { "description": "", "valuecountRange": null, "customValidators": [], "editor": { "name": "textbox", "options": {} } } } } ], "properties": { "caas": { "slug": { "enabled": false, "pattern": "-{name}" } }, "customEditors": [], "groups": [ { "title": "Content Item Data Fields", "collapse": false } ] }, "roleName": "manager", "links": [ { "href": "https://<hostname>/content/management/api/v1.1/types/Type1", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/types/Type1", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/Type1", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" } ], "allowedActions": [ "preview", "read", "write", "update", "delete" ] } }, "links": [ { "href": "https://<hostname>/content/management/api/v1.1/types/Type1/updateType/.status/OPE0ED029409F14E2FA6BE244D7BE0C1E9", "rel": "self", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/types/Type1/updateType/.status/OPE0ED029409F14E2FA6BE244D7BE0C1E9", "rel": "canonical", "method": "GET", "mediaType": "application/json" }, { "href": "https://<hostname>/content/management/api/v1.1/metadata-catalog/types/Type1/updateType/.status/OPE0ED029409F14E2FA6BE244D7BE0C1E9", "rel": "describedby", "method": "GET", "mediaType": "application/schema+json" } ] } }