List Jobs

gethttps://app.mk.io/api/v1/projects/:project_name/media/transforms/:transform_name/jobs

Retrieves a list of Jobs for a Transform.

RBAC Capability Required: ams.job.get

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

transform_namestringRequired

Query parameters

$orderbystringOptional

Specifies the key by which the result collection should be ordered.

$filterstringOptional

Restricts the set of items returned.

$topstringOptional

Specifies a non-negative integer n that limits the number of items returned from a collection. The service returns the number of available items up to but not greater than the specified value n.

$skiptokenstringOptional

Specifies a start offset to support paginated results. Use @odata.nextLink in the result object to enumerate the collection - it will be present only if there's more than one page of entities.

Response

200A list of jobs

Loading schema details…

Errors

400Bad Request

Loading schema details…

401Unauthorized

Loading schema details…

403Forbidden

Loading schema details…

404Not Found

Loading schema details…

429Too Many Requests

Loading schema details…

500Internal Server Error

Loading schema details…

get/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs

curl -X GET "https://app.mk.io/api/v1/projects/{project_name}/media/transforms/{transform_name}/jobs" \
  -H "Authorization: Bearer <token>"

200A list of jobs

{
  "@odata.nextLink": "string",
  "supplemental": {
    "count": 0,
    "kind": "string",
    "operation": "string",
    "pagination": {
      "end": 0,
      "records": 0,
      "start": 0,
      "total": 0
    },
    "subscription": {
      "id": "string",
      "name": "string"
    }
  },
  "value": [
    {
      "id": "string",
      "name": "name",
      "properties": {
        "correlationData": {
          "key": null
        },
        "created": "2024-01-01T00:00:00Z",
        "description": "string",
        "endTime": "string",
        "input": {
          "@odata.type": "#Microsoft.Media.JobInputAsset",
          "assetName": "string",
          "end": {
            "@odata.type": "#Microsoft.Media.AbsoluteClipTime",
            "time": "string"
          },
          "files": [
            "string"
          ],
          "label": "string",
          "start": {
            "@odata.type": "#Microsoft.Media.AbsoluteClipTime",
            "time": "string"
          }
        },
        "lastModified": "2024-01-01T00:00:00Z",
        "outputs": [
          {
            "@odata.type": "#Microsoft.Media.JobOutputAsset",
            "assetName": "string",
            "endTime": "string",
            "error": {
              "category": "Account",
              "code": "ConfigurationUnsupported",
              "message": "string",
              "retry": "DoNotRetry"
            },
            "label": "string",
            "progress": 0,
            "startTime": "string",
            "state": "Queued"
          }
        ],
        "priority": "Normal",
        "recording": {
          "actualEndTime": "string",
          "actualStartTime": "string",
          "details": "string",
          "state": "Scheduled",
          "targetEndTime": "string",
          "targetStartTime": "string"
        },
        "startTime": "2024-01-01T00:00:00Z",
        "state": "Queued"
      },
      "systemData": {
        "createdAt": "2024-01-01T00:00:00Z",
        "createdBy": "string",
        "createdByType": "User",
        "internalId": "00000000-0000-0000-0000-000000000000",
        "lastModifiedAt": "2024-01-01T00:00:00Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User"
      },
      "type": "string"
    }
  ]
}