---
title: "Documents"
method: GET
path: "/workspaces/{wid}/retention/documents"
tags: ["retention"]
---

# Documents

`GET /workspaces/{wid}/retention/documents`

## Request

- Base URL: `https://app.linerecon.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.linerecon.com/workspaces/{wid}/retention/documents`
- Auth: none declared

## Path parameters

- `wid` string, uuid, required

## Query parameters

- `after` string, uuid
- `limit` integer

## Response `200`

Successful Response

- DocumentPreviewView
  - `policy` PolicyView, required
    - `revision` integer, required
    - `retention_days` integer, required
    - `date_basis` 'batch_last_upload', required
    - `automatic_deletion_enabled` boolean, required
    - `automatic_deletion_available` boolean, required
    - `deletion_status` 'off' | 'on' | 'paused', required
    - `deletion_effective_at` string, date-time, nullable, required
    - `automatic_deletion_changed_at` string, date-time, nullable, required
    - `automatic_deletion_changed_by_name` string, nullable, required
    - `deletion_scope` 'uploaded_files_and_page_images', required
    - `full_erasure_supported` boolean, required
    - `limitations` string[], required
  - `as_of` string, date-time, required
  - `items` DocumentPreviewItem[], required
    - `document_id` string, uuid, required
    - `batch_id` string, uuid, required
    - `filename` string, required
    - `uploaded_at` string, date-time, nullable, required
    - `deletion_state` 'off' | 'paused' | 'scheduled' | 'due' | 'deleting' | 'deleted', required
    - `deletes_on` string, date-time, nullable, required
    - `deleted_at` string, date-time, nullable, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `413`: Content Too Large
- `422`: Unprocessable Content
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/linerecon/apis/linerecon-api.md) · [All operations](https://skmtc.dev/linerecon/apis/linerecon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linerecon/apis/linerecon-api/revisions/0650f53a4249?raw)