List documents

Returns all documents in the workspace, newest first. Paginated at 50 items per page by default.

GET/api/v1/documents

Authorization

documents:readapi key scoperequired

Required scope when calling with an API key.

document:readsession capabilityoptional

Required capability when calling with a signed-in session.

Query parameters

pagenumberoptional

Page number (1-based)

Example: 1

per_pagenumberoptional

Items per page, max 50

Example: 50

Request

GET /api/v1/documents

curl -X GET "https://www.digitalstack360.com/api/v1/documents" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": [
    {
      "document_id": "doc_abc123",
      "title": "Q4 Solution Brief",
      "document_type": "vsow",
      "workflow_state": "in_review",
      "is_frozen": false,
      "created_at": "2026-01-10T12:00:00.000Z",
      "updated_at": "2026-01-15T09:30:00.000Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 50
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks documents:read scope