CoreMedia Ingest Service API Reference
Learn the features of the Ingest Service API
What you'll learn
- Get an overview of the Ingest Service API features before you have a login
Prerequisites
- Knowledge of CoreMedia Content Cloud
Time matters
Should I read this?
- Authentication
- Endpoints
- Models
- ActionResultItem
- AsyncJobResult
- AsyncJobResultResponse
- BulkActionResultItem
- BulkResult
- BulkResultResponse
- ContentData
- ContentDataInput
- ContentDataListReadResponse
- ContentDataReadResponse
- ContentDataWriteResponse
- ContentIdList
- ContentRefData
- DateProperty
- ErrorItem
- ErrorResponse
- IntegerProperty
- LinklistProperty
- MarkupProperty
- Property
- PublicationActionResultItem
- ResultItem
- ServerBlobProperty
- ServerBlobPropertyResponse
- StageInfo
- StringProperty
- StructProperty
- TempBlobProperty
- TempBlobPropertyResponse
- UrlBlobProperty
- WarningItem
The CoreMedia Ingest Service is a cloud-only service which enables you to develop your own importer-like applications for the CoreMedia Content Cloud.
It offers an API with basic methods to create and modify content items. In addition, the content lifecycle is supported with bulk publish, withdraw and delete methods.
Authentication
All API calls need to be authenticated using a JSON Web Token (JWT), see https://jwt.io/introduction/. When the Ingest Service is enabled for your cloud environment, you can request access tokens from the CoreMedia Support.
Endpoints
Blob
The BLOB API provides methods for creating server side Binary Large Objects (BLOB). This API is the preferred way of uploading binary data when creating or modifying CoreMedia documents with BLOB properties.
createTempBlob
POST /blobs
Create a temporary server side BLOB
Description
Create a temporary server side BLOB by streaming the binary data to the service endpoint. This is the preferred method when creating CoreMedia documents containing BLOB properties.
The property model returned in the response can be passed directly in a following service call to create or update a document. By default, the temporary BLOB can be accessed up to 10 minutes after creation. After that period, it will be discarded.
This call streams the binary data directly, so it is not possible to use the 'Try it out' function of the Swagger UI.
Parameters
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
Content-Type |
The content type of the binary data. It must be assignable to the BLOB property’s MIME-Type. |
X |
null |
|
Content-Length |
The length of the binary data in bytes |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
contentTypeName |
The name of the CoreMedia content type for which the BLOB is created |
X |
null |
|
propertyName |
The name of the property for which the BLOB is created |
X |
null |
|
preferTikaDetection |
Prefer Tika detected MIME type over supplied MIME type |
- |
null |
|
cleanContentType |
Remove parameters not specified by IANA registration from certain MIME types |
- |
null |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
Result model containing the created temporary BLOB property model |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
500 |
An error was encountered while processing the request. |
Content
The Content API provides all methods for reading, creating and updating content items.
getContents
GET /content
Get the content at the given repository path
Description
Looks up and returns the content found at the given repository path.
This method currently requires the path filter condition and always returns a collection with a single item.
Parameters
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
path |
The content’s repository path |
X |
null |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
Response model with the singleton content item found at the given repository path |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
500 |
An error was encountered while processing the request. |
addContent
POST /content
Create a new content
Description
Creates a new content from the given model.
Since the CMS version 2210.1 the creation of a content with specified UUID is supported.
Missing folders in the target path are created automatically.
Parameters
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
ContentDataInput |
X |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
Response model with the created content |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
409 |
The requested operation conflicts with an existing resource. |
|
500 |
An error was encountered while processing the request. |
getContent
GET /content/{id}
Get the content with the given ID
Description
Looks up and returns the content with the given ID
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id |
The content’s numeric ID |
X |
null |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
Response model with the found content |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
404 |
The requested resource was not found. |
|
500 |
An error was encountered while processing the request. |
getContent
GET /content/{uuid}
Get the content with the given UUID
Description
Looks up and returns the content with the given UUID
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id |
The content’s UUID |
X |
null |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
Response model with the found content |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
404 |
The requested resource was not found. |
|
500 |
An error was encountered while processing the request. |
updateContent
PATCH /content/{id}
Update the content with the given ID
Description
Looks up the content with the given ID and updates its properties from the properties of the input model.
The passed in property set does not have to be complete, partial updates are possible. If the content is checked-out, it will be checked in first, before applying the updates.
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id |
The content’s numeric ID |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
ContentDataInput |
X |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
Response model with the updated content |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
404 |
The requested resource was not found. |
|
500 |
An error was encountered while processing the request. |
getBlobData
GET /content/{id}/properties/{propertyName}/data
Get the raw BLOB data from the content with the given ID and property name
Description
Looks up the content with the given ID and returns the raw BLOB data from the property with the given name
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id |
The content’s numeric ID |
X |
null |
|
propertyName |
The name of content’s BLOB property |
X |
null |
Return Type
Content Type
-
*/*
Responses
Code | Message | Datatype |
---|---|---|
200 |
A raw binary stream of the BLOB’s data |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
404 |
The requested resource was not found. |
|
500 |
An error was encountered while processing the request. |
postBlobData
POST /content/{id}/properties/{propertyName}/data
Update a content’s BLOB property
Description
Looks up the content with the given ID and updates the BLOB property with the given name with the data streamed in the request body.
If the content is checked-out, it will be checked in first, before applying the update.
This call streams the binary data directly, so it is not possible to use the 'Try it out' function of the Swagger UI.
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id |
The content’s numeric ID |
X |
null |
|
propertyName |
The name of the content’s BLOB property |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
Content-Type |
The content type of the binary data. It must be assignable to the property’s MIME-Type. |
X |
null |
|
Content-Length |
The length of the binary data in bytes |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
preferTikaDetection |
Prefer Tika detected MIME type over supplied MIME type |
- |
null |
|
cleanContentType |
Remove parameters not specified by IANA registration from certain MIME types |
- |
null |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
Result model containing the updated server side BLOB property model |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
404 |
The requested resource was not found. |
|
500 |
An error was encountered while processing the request. |
Repository
The Repository API provides bulk operations to handle the content lifecycle of CoreMedia content. It supports synchronous and asynchronous operation.
publishAll
POST /repository/publish-all
Publish the given set of content items
Description
Publishes the given set of content items in one bulk operation.
The latest version and the place of each item is approved before publication. Additionally, the folders up to the root are place approved and published for each item if needed. If an item is a folder, the operation is applied recursively to all children.
The bulk operation is not executed in one transaction. If the operation fails, content items might be in an intermediate state, for example fully approved but not published yet. In this case, check the result’s error messages for detailed information.
Parameters
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
ContentIdList |
X |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
The bulk operation result. |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
429 |
The request cannot be processed due to capacity limits. |
|
500 |
An error was encountered while processing the request. |
withdrawAll
POST /repository/withdraw-all
Withdraw (unpublish) the given set of content items
Description
Withdraws the given set of content items in one bulk operation.
On each item the withdrawal flag is set and its place is approved before unpublication. If an item is a folder, the operation is applied recursively to all children.
The bulk operation is not executed in one transaction. If the operation fails, content items might be in an intermediate state, for example having the withdrawal flag set but not unpublished yet. In this case, check the result’s error messages for detailed information.
Parameters
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
ContentIdList |
X |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
The bulk operation result. |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
429 |
The request cannot be processed due to capacity limits. |
|
500 |
An error was encountered while processing the request. |
deleteAll
POST /repository/delete-all
Delete the given set of content items
Description
Unpublishes and moves the given set of content items to the recycle bin in one bulk operation.
On each item the withdrawal flag is set and its place is approved before unpublication. After unpublication, all items are moved to the recycle bin. If an item is a folder, the operation is applied recursively to all children.
The bulk operation is not executed in one transaction. If the operation fails, content items might be in an intermediate state, for example having the withdrawal flag set but not deleted yet. In this case, check the result’s error messages for detailed information.
Parameters
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
ContentIdList |
X |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
The bulk operation result. |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
429 |
The request cannot be processed due to capacity limits. |
|
500 |
An error was encountered while processing the request. |
publishAllAsync
POST /repository/publish-all-async
Publish the given set of content items asynchronously
Description
Publishes the given set of content items in one asynchronous bulk operation.
The latest version and the place of each item is approved before publication. Additionally, the folders up to the root are place approved and published for each item if needed. If an item is a folder, the operation is applied recursively to all children.
The bulk operation is not executed in one transaction. If the operation fails, content items might be in an intermediate state, for example fully approved but not published yet.
This call returns the initial state upon scheduling the operation. Updates can be fetched by using the returned ID from the initial state (see method /jobs/{id}).
Parameters
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
ContentIdList |
X |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
202 |
The initial state of the asynchronous bulk operation |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
429 |
The request cannot be processed due to capacity limits. |
|
500 |
An error was encountered while processing the request. |
withdrawAllAsync
POST /repository/withdraw-all-async
Withdraw (unpublish) the given set of content items asynchronously
Description
Withdraws the given set of content items in one asynchronous bulk operation.
On each item the withdrawal flag is set and its place is approved before unpublication. If an item is a folder, the operation is applied recursively to all children.
The bulk operation is not executed in one transaction. If the operation fails, content items might be in an intermediate state, for example having the withdrawal flag set but not unpublished yet.
This call returns the initial state upon scheduling the operation. Updates can be fetched by using the returned ID from the initial state (see method /jobs/{id}).
Parameters
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
ContentIdList |
X |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
202 |
The initial state of the asynchronous bulk operation |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
429 |
The request cannot be processed due to capacity limits. |
|
500 |
An error was encountered while processing the request. |
deleteAllAsync
POST /repository/delete-all-async
Delete the given set of content items asynchronously
Description
Unpublishes and moves the given set of content items to the recycle bin in one asynchronous bulk operation.
On each item the withdrawal flag is set and its place is approved before unpublication. After unpublication, all items are moved to the recycle bin. If an item is a folder, the operation is applied recursively to all children.
The bulk operation is not executed in one transaction. If the operation fails, content items might be in an intermediate state, for example having the withdrawal flag set but not deleted yet.
This call returns the initial state upon scheduling the operation. Updates can be fetched by using the returned ID from the initial state (see method /jobs/{id}).
Parameters
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
ContentIdList |
X |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
202 |
The initial state of the asynchronous bulk operation |
|
400 |
The request or its input data is invalid. |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
429 |
The request cannot be processed due to capacity limits. |
|
500 |
An error was encountered while processing the request. |
getAsyncJob
GET /repository/jobs/{id}
Get the state of the asynchronous bulk operation with the given ID
Description
Returns the state of the bulk operation with the given ID.
The state can be fetched up to 10 minutes after - successful or failed - completion of the bulk operation. After that period, the state will be discarded.
Once completed without an unexpected error the state contains a result object which can be inspected in the same way as the result object from a synchronous call.
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
id |
The ID of the asynchronous job |
X |
null |
Return Type
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
The state of the requested asynchronous bulk operation |
|
401 |
The request is missing a valid authentication |
|
403 |
The user is missing the necessary authorization to perform the operation on the requested content item |
|
410 |
The requested resource is not available anymore. |
|
500 |
An error was encountered while processing the request. |
Models
ActionResultItem
Result of an action on a single content item during an Ingest Service bulk operation
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: ActionResultItem, |
stage |
X |
String |
The current stage when the item result was created |
Enum: CHECK_RIGHTS, MARK_WITHDRAW, APPROVE_LATEST_VERSION, APPROVE_PLACE, PUBLISH, DELETE, |
params |
X |
List of String |
||
code |
X |
String |
The item’s result code |
Enum: CONTENT_ERROR, UNEXPECTED_ERROR, INSUFFICIENT_RIGHTS, CONTENT_IS_DELETED, CONTENT_IS_CHECKED_OUT, NO_APPROVE_RIGHT, NO_APPROVE_RIGHT_IN_PATH, NO_DELETE_RIGHT, NO_DELETE_RIGHT_IN_PATH, NO_PUBLISH_RIGHT, PUBLICATION_FAILED_EXCEPTION, PUBLICATION_EXCEPTION, BULK_OPERATION_FAILED, BULK_OPERATION_CONTENT_ERROR, |
AsyncJobResult
Execution state of an asynchronous bulk operation.
The initial state is returned when calling the asynchronous repository method. It can be refreshed up to 10 minutes after the execution of the bulk operation finished (successfully or unsuccessfully).
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
id |
X |
UUID |
The job’s unique ID |
uuid |
type |
X |
String |
The bulk operation’s type |
Enum: PUBLICATION, WITHDRAWAL, DELETION, |
scheduledAt |
X |
String |
The date and time the bulk operation was scheduled for execution. |
|
startedAt |
X |
String |
The time and date the bulk operation’s execution started. |
|
finishedAt |
X |
String |
The time and date the bulk operation’s execution finished (successfully or due to an error or cancellation). |
|
state |
X |
String |
The bulk operation’s current state |
Enum: SCHEDULED, RUNNING, FINISHED, FAILED, CANCELLED, |
bulkResult |
||||
errors |
List of ErrorItem |
The encountered errors if the bulk operation terminated abnormally |
AsyncJobResultResponse
Response model for the state of an asynchronous bulk operation
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
data |
BulkActionResultItem
Result of an Unified API bulk operation on a single content item during an Ingest Service bulk operation
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: BulkActionResultItem, |
stage |
X |
String |
The current stage when the item result was created |
Enum: CHECK_RIGHTS, MARK_WITHDRAW, APPROVE_LATEST_VERSION, APPROVE_PLACE, PUBLISH, DELETE, |
params |
X |
List of String |
||
code |
X |
String |
The item’s result code. |
Enum: UNKNOWN, OK, NOOP, NOT_PUBLISHED, ALREADY_PUBLISHED, CHECKED_OUT, DELETED, FAILED, NOT_AUTHORIZED, UNPROCESSED_CHILD, PARENT_DELETED, TO_BE_DELETED, DUPLICATE_NAME, INVALID_NAME, WIDE_LINK, |
BulkResult
Result model for a bulk operation.
If the bulk operation executed Unified API bulk operations or publications, the model contains detailed information about the actions taken on each content item.
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
successful |
X |
Boolean |
Indicates weather the bulk operation as a whole was successful |
|
scheduledAt |
X |
String |
The date and time the bulk operation was scheduled for execution. |
|
startedAt |
X |
String |
The time and date the bulk operation’s execution started. |
|
finishedAt |
X |
String |
The time and date the bulk operation’s execution finished (successfully or due to an error or cancellation). |
|
stageInfos |
X |
List of StageInfo |
||
errors |
X |
List of ResultItem |
||
warnings |
X |
List of ResultItem |
||
info |
X |
List of ResultItem |
BulkResultResponse
Response model for the result of a synchronous bulk operation
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
data |
ContentData
Model object for a content
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
id |
X |
String |
The content’s unique identifier |
|
uuid |
X |
UUID |
The content’s UUID |
uuid |
path |
X |
String |
The content’s repository path. |
|
type |
X |
String |
The content’s type name. |
|
links |
X |
Map |
Map of content’s links. Currently, there are children, references and referrers. |
|
lifeCycleStatus |
X |
String |
The content’s current state in the simplified editorial lifecycle for Studio users |
Enum: DELETED, APPROVED, PUBLISHED, IN_PRODUCTION, |
creationDate |
X |
String |
The content’s creation date. |
|
modificationDate |
X |
String |
The content’s last modification date. |
|
editionDate |
X |
String |
The date the content’s properties were last saved. |
|
publicationDate |
X |
String |
The date the content was published. |
|
children |
X |
List of ContentRefData |
The content’s children. |
|
properties |
X |
Map of Property |
The content’s properties. |
|
inProduction |
X |
Boolean |
A flag indicating if the content is neither deleted nor destroyed |
|
published |
X |
Boolean |
A flag indicating if the content is published (exists on the live side) |
ContentDataInput
The input model for creating new content or updating content.
This is actually the same as ContentData and only required for the Swagger UI to add meaningful examples.
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
uuid |
UUID |
The content’s UUID. |
uuid |
|
path |
X |
String |
The content’s repository path. |
|
type |
X |
String |
The content’s type name. |
|
properties |
X |
Map of Property |
The content’s properties. |
ContentDataListReadResponse
Response model for a list of content items
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
data |
List of ContentData |
ContentDataReadResponse
Response model for a content
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
data |
ContentDataWriteResponse
Response model for a content
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
data |
||||
warnings |
List of WarningItem |
ContentIdList
The IDs of the content items to delete
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
ids |
List of String |
ContentRefData
Model object for a content reference
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
id |
X |
String |
The content’s unique identifier |
|
uuid |
X |
UUID |
The content’s UUID |
uuid |
path |
X |
String |
The content’s repository path |
|
type |
X |
String |
The content’s type name |
DateProperty
Property model holding a date value
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: Date, |
value |
X |
String |
The date value as string. |
ErrorItem
Error information
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
code |
X |
String |
The error code |
|
message |
X |
String |
The error message |
ErrorResponse
Generic error response
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
errors |
List of ErrorItem |
IntegerProperty
Property model holding an integer value
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: Integer, |
value |
X |
Integer |
The integer value |
int32 |
LinklistProperty
Property model holding a list of content references
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: Linklist, |
references |
List of ContentRefData |
MarkupProperty
Property model holding a markup string
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: Markup, |
value |
X |
String |
The markup value as string |
|
failOnError |
Boolean |
If set to 'true', markup which is invalid against the property type’s grammar will cause an error when creating or updating content |
||
skipOnUnresolvableGrammar |
Boolean |
If set to 'true', markup validation will be skipped if the property type’s grammar cannot be accessed by the ingest service (which currently is the case for all customer defined grammars) |
Property
Abstract parent of property models.
The following types are the concrete subtypes:
-
DateProperty
-
IntegerProperty
-
LinklistProperty
-
MarkupProperty
-
ServerBlobProperty
-
StringProperty
-
StructProperty
-
TempBlobProperty
-
UrlBlobProperty
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator for subtypes |
Enum: Date, Integer, Linklist, Markup, ServerBlob, String, Struct, TempBlob, UrlBlob, |
PublicationActionResultItem
Result of a Unified API publication action on a single content item during an Ingest Service bulk operation
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: PublicationActionResultItem, |
stage |
X |
String |
The current stage when the item result was created |
Enum: CHECK_RIGHTS, MARK_WITHDRAW, APPROVE_LATEST_VERSION, APPROVE_PLACE, PUBLISH, DELETE, |
params |
X |
List of String |
||
code |
X |
String |
The item’s result code. |
Enum: UNKNOWN, NOOP, VERSION_PUBLISHED, CREATED, MOVED, DELETED, WITHDRAWN, ALREADY_PUBLISHED, LATER_VERSION, DOES_NOT_EXIST, PLACE_NOT_APPROVED, VERSION_NOT_APPROVED, SELECT_VERSION, NO_APPROVED_VERSION, ALREADY_DELETED, LINK_FAILED, CREATE_PARENT_FAILED, TARGET_NAME_CONFLICT, NAME_CHANGED, NO_RIGHT_TO_PUBLISH, CANNOT_WITHDRAW_BECAUSE_OF_LINK, CANNOT_PUBLISH_DELETED, ORPHANED, MUST_DELETE_CHILD, NOT_BELOW_BASE_FOLDER, |
ResultItem
Abstract parent of bulk operation result items.
The following types are the concrete subtypes:
-
ActionResultItem
-
BulkActionResultItem
-
PublicationActionResultItem
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator for subtypes |
Enum: ActionResultItem, BulkActionResultItem, PublicationActionResultItem, |
stage |
X |
String |
The current stage when the item result was created |
Enum: CHECK_RIGHTS, MARK_WITHDRAW, APPROVE_LATEST_VERSION, APPROVE_PLACE, PUBLISH, DELETE, |
params |
X |
List of String |
ServerBlobProperty
Property model holding the attributes of a server side BLOB.
Only valid as a response - cannot be used for creating or updating content items.
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: ServerBlob, |
url |
X |
String |
The URL to retrieve the BLOB’s binary data. |
|
mimeType |
X |
String |
The BLOB’s MIME-Type |
|
size |
X |
Integer |
The BLOB’s size |
int32 |
etag |
X |
String |
The BLOB’s unique hash |
ServerBlobPropertyResponse
Response model for an updated BLOB
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
data |
||||
warnings |
List of WarningItem |
StageInfo
Model for the different stages executed during a bulk operation.
For a publication these are:
-
CHECK_RIGHTS
-
APPROVE_LATEST_VERSION
-
APPROVE_PLACE
-
PUBLISH
For a withdrawal these are:
-
CHECK_RIGHTS
-
MARK_WITHDRAW
-
APPROVE_PLACE
-
PUBLISH
For a deletion these are:
-
CHECK_RIGHTS
-
MARK_WITHDRAW
-
APPROVE_PLACE
-
PUBLISH
-
DELETE
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
stage |
X |
String |
The name of the stage |
Enum: CHECK_RIGHTS, MARK_WITHDRAW, APPROVE_LATEST_VERSION, APPROVE_PLACE, PUBLISH, DELETE, |
startedAt |
X |
String |
The date and time the stage was started. |
StringProperty
Property model holding a string value
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: String, |
value |
X |
String |
The string value |
StructProperty
Property model holding a struct markup string
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: Struct, |
value |
X |
String |
The struct value as string |
TempBlobProperty
Property model holding the attributes of a temporary server side BLOB
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: TempBlob, |
id |
X |
String |
The BLOB’s unique ID |
|
mimeType |
X |
String |
The BLOB’s MIME-Type |
|
size |
X |
Integer |
The BLOB’s size |
int32 |
TempBlobPropertyResponse
Response model for a created temporary server side BLOB
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
data |
||||
warnings |
List of WarningItem |
UrlBlobProperty
Property model holding the attributes of an URL BLOB.
URL BLOB’s are used in two different cases:
-
Ingesting binary data via a URL reference.
-
Reading a persistent URL BLOB from the Content Server.
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
type |
X |
String |
Type discriminator |
Enum: UrlBlob, |
url |
X |
String |
The BLOB’s URL. |
|
mimeType |
String |
The BLOB’s MIME-Type. |
||
size |
Integer |
The BLOB’s size. |
int32 |
|
preferTikaDetection |
Boolean |
If set to 'true', the MIME type returned by Tika will override any value explicitly specified or extracted from the URL stream |
||
cleanMimeType |
Boolean |
By default parameters are sanitized for a limited number of MIME types. |
||
persistent |
X |
Boolean |
Flag if the BLOB’s data URL is persistent. |
WarningItem
Warning information
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
code |
X |
String |
The warning code |
|
message |
X |
String |
The warning message |