# Return Items from a Job

Moves each item out of the job folder and into destination_folder_id, up to 100 per request. Items are processed one by one, so check errors in the response.

Endpoint: POST /api/v1/jobs/{job_id}/items/return
Security: BearerAuth

## Path parameters:

  - `job_id` (number, required)
    ID of the job
    Example: "101"

## Request fields (application/json):

  - `items` (array, required)
    1 to 100 items per request.

  - `items.item_id` (number, required)
    ID of the item on the job to move off it.

  - `items.quantity` (number, required)
    Quantity to move.

  - `items.item_version` (number)
    The version from the last read of the item. A stale version is rejected.

  - `items.destination_folder_id` (number)
    Folder to return the item to. If not defined the item is moved to All Items.

  - `items.leave_zero_quantity` (boolean)
    Keep a zero-quantity copy of the item in the job's folder. Default is false.

  - `action` (object)
    Optional action reason recorded in the item's history.

  - `action.reason_id` (string)
    UID of a move-type action reason.

  - `action.notes` (string)

## Response 200 fields (application/json):

  - `data` (object)

  - `data.returned_item_ids` (array)
    Items at the destination. Where a return merges into an item already there, this is a different id from the one sent

  - `data.errors` (array)

  - `data.errors.item_id` (number)

  - `data.errors.name` (string)

  - `data.errors.error` (string)

## Response 400 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 401 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 403 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 404 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 409 fields (application/json):

  - `message` (string)

  - `errors` (object,null)

## Response 429 fields (application/json):

  - `message` (string)