Vionlabs Docs

Vionlabs Tasks API

External docs:SwaggerReDoc

Vionlabs API for creating, retrieving and deactivating processing tasks for catalog assets and product versions. Tasks are used to orchestrate processing and expose the current state of requested work across the system. To fully understand how tasks relate to catalog items and product results, developers and integrators should consult the relevant section of the Vionlabs developer documentation.

Get Task Status

Returns the status of the processing task for the given inventory item and product version.

GET
/tasks/catalog-item/{inventory_id}/product/{product}/version/{version}
X-API-Key<token>

In: header

Path Parameters

inventory_idInventory Id

Customer's identifier for an asset in the catalog

productProductType

Specify product name

versionVersion

Specify product version. Example: 1.0.1

Response Body

curl -X GET "https://loading/tasks/catalog-item/string/product/adbreaks/version/string"
{
  "status": "pending",
  "error": "string",
  "_links": {
    "property1": {
      "href": "string",
      "method": "string"
    },
    "property2": {
      "href": "string",
      "method": "string"
    }
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Create Task

Creates a processing task for the given inventory item and product version.

POST
/tasks/catalog-item/{inventory_id}/product/{product}/version/{version}
X-API-Key<token>

In: header

Path Parameters

inventory_idInventory Id

Customer's identifier for an asset in the catalog

productProductType

Specify product name

versionVersion

Specify product version. Example: 1.0.1

priority?TaskPriority
Default"low"

Response Body

curl -X POST "https://loading/tasks/catalog-item/string/product/adbreaks/version/string" \  -H "Content-Type: application/json" \  -d '{    "priority": "low"  }'
{
  "status": "pending",
  "error": "string",
  "_links": {
    "property1": {
      "href": "string",
      "method": "string"
    },
    "property2": {
      "href": "string",
      "method": "string"
    }
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Deactivate Task

Deactivate a processing task for the given inventory item and product version.

DELETE
/tasks/catalog-item/{inventory_id}/product/{product}/version/{version}
X-API-Key<token>

In: header

Path Parameters

inventory_idInventory Id

Customer's identifier for an asset in the catalog

productProductType

Specify product name

versionVersion

Specify product version. Example: 1.0.1

Response Body

curl -X DELETE "https://loading/tasks/catalog-item/string/product/adbreaks/version/string"
{
  "status": "pending",
  "error": "string",
  "_links": {
    "property1": {
      "href": "string",
      "method": "string"
    },
    "property2": {
      "href": "string",
      "method": "string"
    }
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Get Task Status

Returns the status of the processing task for the given inventory item.

GET
/tasks/catalog-item/{inventory_id}
X-API-Key<token>

In: header

Path Parameters

inventory_idInventory Id

Customer's identifier for an asset in the catalog

Response Body

curl -X GET "https://loading/tasks/catalog-item/string"
[
  {
    "task_status": {
      "status": "pending",
      "error": "string"
    },
    "product": "string",
    "version": "string"
  }
]
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}