Update assets' lifecycle stage

Request

Move a set of Asset resources from one Asset.lifecycleStatus.state to another.

The Asset resources to be added to the batch job are specified using the AssetSearch criteria language or by a simple set of ids

If you are selecting by search criteria you must explicitly include criteria describing the state you are moving from in order to account for the fact that the Dash API will only return Assets in the 'LIVE' state by default. See the request examples for more.

Security

bearerToken

Bodyapplication/jsonrequired

selectorany

transitionstring

The transition. Generally describe the state moving from and to.

Enum:"STAGED_TO_PENDING_APPROVAL""STAGED_TO_LIVE""PENDING_APPROVAL_TO_LIVE""LIVE_TO_BINNED""BINNED_TO_LIVE"

curl -i -X POST \
  https://api-v2.dash.app/asset-lifecycle-transition-batch-jobs \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "transition": "STAGED_TO_PENDING_APPROVAL",
    "selector": {
      "type": "BY_CRITERION",
      "criterion": {
        "type": "AND",
        "criteria": [
          {
            "type": "FIELD_EQUALS",
            "value": "STAGED",
            "field": {
              "type": "FIXED",
              "fieldName": "LIFECYCLE_STATE"
            }
          },
          {
            "type": "FIELD_EQUALS",
            "value": "google-oauth2|110457667287511486432",
            "field": {
              "type": "FIXED",
              "fieldName": "STAGED_BY"
            }
          }
        ]
      }
    }
  }'

Responses

Success

Bodyapplication/json

idstringrequired

Unique identifier of the job that has been created

Example:"be161977-d44e-4888-af3c-66522e223963"

accountIdstringrequired

The ID of the account the job is happening in

Example:"cfb665ca-ce35-4418-b9d5-70ee815db4bd"

creatorIdstringrequired

The ID of the User who created the job

Example:"google-oauth2|110955770826801837334"

typestringrequired

The job type

Value:"IN_PROGRESS"

Discriminator

progressobjectrequired

statusstringrequired

Enum:"PENDING""STARTING""STARTED""STOPPING"

Response

{
  "id": "be161977-d44e-4888-af3c-66522e223963",
  "accountId": "cfb665ca-ce35-4418-b9d5-70ee815db4bd",
  "creatorId": "google-oauth2|110955770826801837334",
  "type": "IN_PROGRESS",
  "status": "PENDING",
  "progress": {
    "steps": [ … ]
  }
}