# List upload processing jobs in queue

Retrieves upload processing jobs from a specific queue (submitted, in_progress, or completed). Used to monitor the status of async upload processing tasks such as image resizing, video encoding, or thumbnail generation. Supports filtering by upload type and sorting by various fields like submission time or processing duration.

RBAC: requires Uploads.Read

Endpoint: GET /api/v1/admin/uploads/jobs/queue/{queueName}
Version: 1.0
Security: 

## Path parameters:

  - `queueName` (string, required)
    Queue name to retrieve jobs from (submitted, in_progress, completed)

## Query parameters:

  - `limit` (integer)
    Maximum number of jobs to return. Default is 10.

  - `offset` (integer)
    Pagination offset for results. Default is 0.

  - `sortBy` (string,null)
    Field to sort by (submission_time, processing_duration, etc.)

  - `sortOrder` (string,null)
    Sort order direction. Values: 'asc' or 'desc'. Default is ascending.

  - `uploadType` (string,null)
    Filter by upload type (IMAGE, VIDEO, AUDIO, DOCUMENT)

## Response 200 fields (application/json):

  - `list` (array, required)

  - `list.jobId` (string, required)
    UUID with type prefix
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `list.uploadId` (string, required)
    UUID with type prefix
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `list.uploadType` (string, required)
    Upload type: IMAGE, VIDEO, AUDIO, DOCUMENT
    Enum: "VIDEO", "IMAGE", "AUDIO", "DOCUMENT", "OTHER"

  - `list.originalFileSize` (integer)

  - `list.attempts` (integer)

  - `list.progress` (number)

  - `list.properties` (array, required)

  - `list.properties.extension` (string, required)

  - `list.properties.width` (integer,null)

  - `list.properties.height` (integer,null)

  - `list.properties.rotation` (integer)

  - `list.properties.thumbnailSecond` (number,null)

  - `list.deleteOriginal` (boolean)

  - `list.error` (string,null)

  - `list.startedAt` (string,null)
    Example: "2022-03-10T16:15:50Z"

  - `list.finishedAt` (string,null)
    Example: "2022-03-10T16:15:50Z"

  - `list.createdAt` (string, required)
    Example: "2022-03-10T16:15:50Z"

  - `list.updatedAt` (string, required)
    Example: "2022-03-10T16:15:50Z"

  - `list.upload` (object,null)
    Uploaded file

  - `list.upload.uploadId` (string, required)
    Internal id
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `list.upload.userId` (string, required)
    User id this upload belongs to
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `list.upload.uploadType` (string, required)
    Type of the upload
    Enum: "VIDEO", "IMAGE", "AUDIO", "DOCUMENT", "OTHER"

  - `list.upload.meta` (object, required)
    Meta data

  - `list.upload.meta.blurhash` (string,null)

  - `list.upload.meta.name` (string,null)

  - `list.upload.meta.altText` (string,null)

  - `list.upload.size` (integer, required)
    Size in bytes of all the files in this upload

  - `list.upload.files` (array, required)
    List of all the files this upload has

  - `list.upload.files.uri` (string,null, required)
    Full url of the file

  - `list.upload.files.fileId` (string, required)
    File id
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `list.upload.files.extension` (string, required)
    File extension
    Example: "mp4"

  - `list.upload.files.original` (boolean, required)
    true if this file is original, false if it is a derivative

  - `list.upload.files.meta` (object, required)
    File metadata. Contains optional values for width, height etc.

  - `list.upload.files.meta.duration` (number,null)
    Video duration in seconds

  - `list.upload.files.meta.width` (integer,null)
    Media width

  - `list.upload.files.meta.height` (integer,null)
    Media height

  - `list.upload.files.meta.codec` (string,null)
    Video codec

  - `list.upload.files.meta.rotate` (integer,null)
    Rotation in degrees

  - `list.upload.files.size` (integer, required)
    File size in bytes

  - `list.upload.files.type` (string, required)
    File type
    Enum: "VIDEO", "IMAGE", "AUDIO", "DOCUMENT", "OTHER"

  - `list.upload.tags` (array, required)
    List of tags attached to upload
    Enum: "Post", "Avatar", "Header", "Album", "Emoji", "Event"

  - `list.upload.error` (string,null)
    Upload processing error

  - `list.upload.cached` (boolean)
    true if cached

  - `list.upload.logs` (string,null)
    Logs

  - `list.upload.remote` (boolean)
    true if this upload is remote

  - `total` (integer)
    Total number of jobs in the queue.

  - `totalJobs` (integer)
    Total number of jobs in the queue with specified filter.

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation