Workflow

Fire workflow action by name

Fires a workflow action, specified by name, on a target contentlet.

Returns a map of the resultant contentlet, with an additional AUTO_ASSIGN_WORKFLOW property, which can be referenced by delegate services that handle automatically assigning workflow schemes to content with none.

When chaining workflow actions or reading state back immediately after firing, pass indexPolicy=WAIT_FOR on each call. The default DEFER is asynchronous and can return stale index reads for several seconds, which can mimic server-side state bugs. For isolated one-off fires where nothing reads the result, leave the default.

put/api/v1/workflow/actions/fire

Query parameters

inodestring

Inode of the target content.

identifierstring

Identifier of target content.

indexPolicy'DEFER' | 'WAIT_FOR' | 'FORCE'

Determines how target content is indexed.

ValueDescription
DEFERContent will be indexed asynchronously, outside of the current process. Valid content will finish the method in process and be returned before the content becomes visible in the index. This is the default index policy; it is resource-friendly and well-suited to batch processing.
WAIT_FORThe API call will not return from the content check process until the content has been indexed. Ensures content is promptly available for searching.
FORCEForces Elasticsearch to index the content immediately.<br>Caution: Using this value may cause system performance issues; it is not recommended for general use, though may be useful for testing purposes.
languagestring

Language version of target content.

Request body

commentsstring
assignstring
publishDatestring
publishTimestring
expireDatestring
expireTimestring
neverExpirestring
whereToSendstring
filterKeystring
querystring
pathToMovestring
timezoneIdstring
individualPermissionsobject
actionNamestring
iwantTostring
contentletobject

Response

Fired action successfully

entityobject
i18nMessagesMapobject
permissionsstring[]

Changes