List Workspace Documents - Raydocs

List workspace-scoped documents that can be reused across sessions and runs.

Authentication & Scope

Requires documents-read.

Request

GET /workspaces/12/documents?query=invoice&status=processed&page=1&per_page=20 HTTP/1.1
Host: api.raydocs.com
Authorization: Bearer <token>

Query Parameters

Parameter	Type	Description
`query`	string	Search by filename, source URL, or hash
`mime`	string	Filter by MIME type
`status`	string	Filter by document status
`source_type`	string	`upload`, `url`, or `connector`
`sort`	string	`created_at`, `filename`, `size`, `status`
`order`	string	`asc` or `desc`
`page`	integer	Page number
`per_page`	integer	Items per page (max 100)

Response

200 OK

{
  "data": [
    {
      "id": "880e8400-e29b-41d4-a716-446655440000",
      "workspace_id": 12,
      "filename": "invoice.pdf",
      "mime": "application/pdf",
      "size": 123456,
      "sha256": "6de7f6f5894c9f3fd1f6f8a4d1b3115d0d9b4b19d7a8a661f9fe90f9c2d80c3b",
      "status": "processed",
      "source_type": "upload",
      "created_at": "2026-02-28T10:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 153,
    "last_page": 8
  }
}