# Update queue item status

**Requires scope:** `payroll_hours`.
You can update the status of a queue item in Dyflexis when processing the payroll period queue.
The status is displayed in the Dyflexis payroll page.

Endpoint: POST /api2/payroll/queue/{queueId}/status
Security: apiKey

## Path parameters:

  - `queueId` (string, required)
    The queue item id for which to update the status

## Request fields (application/json):

  - `status` (any, required)
    The new status for the queue item

  - `application` (string, required)
    An external application identifier. This allows multiple applications to process queue items and send individual status updates.

  - `message` (string)
    The reason for this status
    Example: Invalid contract for user 125

  - `url` (string)
    URL for more information about this status
    Example: https://www.example-payrollapplication.com/api-processing/error/1234-AA9D

## Response 200 fields (application/json):

  - `payrollPeriodStatus` (object)

  - `payrollPeriodStatus.queueId` (integer)

  - `payrollPeriodStatus.application` (string)

  - `payrollPeriodStatus.status` (string)

  - `payrollPeriodStatus.message` (string)

  - `payrollPeriodStatus.url` (string)

## Response 401 fields (application/json):

  - `title` (string, required)
    Short, human-readable summary of the error.
    Example: Unauthorized

  - `status` (integer, required)
    The HTTP status code.
    Example: 401

  - `message` (string, required)
    Human-readable explanation of this occurrence of the error.
    Example: Invalid Token

  - `detail` (string)
    Human-readable explanation of this occurrence. Not returned by all backend versions.
    Example: Invalid Token

  - `code` (integer)
    The HTTP status code (duplicate of `status`). Not returned by all backend versions.
    Example: 401

## Response 403 fields (application/json):

  - `title` (string, required)
    Short, human-readable summary of the error.
    Example: Unauthorized

  - `status` (integer, required)
    The HTTP status code.
    Example: 401

  - `message` (string, required)
    Human-readable explanation of this occurrence of the error.
    Example: Invalid Token

  - `detail` (string)
    Human-readable explanation of this occurrence. Not returned by all backend versions.
    Example: Invalid Token

  - `code` (integer)
    The HTTP status code (duplicate of `status`). Not returned by all backend versions.
    Example: 401