---
title: "List Vault Projects and Knowledge Bases"
method: GET
path: "/api/v1/vault/workspace/projects"
tags: ["Vault"]
---

# List Vault Projects and Knowledge Bases

`GET /api/v1/vault/workspace/projects`

Lists all Vault projects and knowledge bases in the current workspace with pagination support. This endpoint returns a paginated list of projects that the authenticated user has permission to view.

## Query parameters

- `page` integer
- `per_page` integer
- `name` string
- `is_knowledge_base` boolean
- `created_after` integer
- `created_before` integer
- `sort_by` 'date' | 'name'
- `sort_order` 'asc' | 'desc'

## Response `200`

Successfully retrieved workspace projects

- object
  - `response` object
    - `content` object
      - `projects` Project[] — Array of projects in the workspace
        - `id` string, uuid — The unique identifier of the project
        - `name` string — The name of the project
        - `client_matter_id` string, uuid, nullable — The associated client matter UUID (not the human-readable matter number)
        - `created_at` string, date-time — Timestamp when the project was created
        - `updated_at` string, date-time — Timestamp when the project metadata was last updated
        - `project_updated_at` string, date-time — Timestamp when the project content was last updated
        - `project_retained_at` string, date-time, nullable — Timestamp when the vault project is retained. This date can be in the future. This field is only present in the response when it is non-null; it is omitted when the project has no retention timestamp set.
        - `creator_email` string, email — Email of the user who created the project
        - `is_knowledge_base_project` boolean — Whether this project is designated as a knowledge base
        - `files_count` integer — Number of files in the project
        - `size_bytes` integer — Total size of all files in bytes
        - `query_count` integer — Number of queries made against this project
        - `sharing` object — Sharing information for the project
          - `user_count` integer — Number of users the project is shared with
          - `user_shares` ShareDetails[] — List of user share details
            - `created_at` string, date-time — When the share was created
            - `dest_user_email` string, email — Email of the destination user (for user shares)
            - `dest_user_id` string, uuid — ID of the destination user (for user shares)
            - `dest_workspace_id` integer — Destination workspace ID
            - `permission_level` 'VIEW' | 'EDIT' | 'ADMIN' — Permission level for the share
            - `src_user_id` string, uuid — Source user ID who created the share
            - `src_workspace_id` integer — Source workspace ID
            - `vault_folder_id` string, uuid — The vault folder/project ID being shared
          - `workspace_count` integer — Number of workspaces the project is shared with
          - `workspace_shares` ShareDetails[] — List of workspace share details
            - `created_at` string, date-time — When the share was created
            - `dest_user_email` string, email — Email of the destination user (for user shares)
            - `dest_user_id` string, uuid — ID of the destination user (for user shares)
            - `dest_workspace_id` integer — Destination workspace ID
            - `permission_level` 'VIEW' | 'EDIT' | 'ADMIN' — Permission level for the share
            - `src_user_id` string, uuid — Source user ID who created the share
            - `src_workspace_id` integer — Source workspace ID
            - `vault_folder_id` string, uuid — The vault folder/project ID being shared
      - `pagination` object
        - `page` integer — Current page number
        - `per_page` integer — Number of items per page
        - `total` integer — Total number of projects
        - `total_pages` integer — Total number of pages

## Other responses

- `400` — Bad request - Invalid query parameters (e.g. `page < 1`, `per_page > 100`, malformed `created_after`/`created_before`, `created_after >= created_before`, or unrecognized `sort_by`/`sort_order` value)
- `401` — Unauthorized - Invalid or missing API token
- `403` — Forbidden - User does not have permission to view workspace projects
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/harvey/apis/harvey-client-matter-api.md) · [All operations](https://skmtc.dev/harvey/apis/harvey-client-matter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/harvey/harvey-client-matter-api/revisions/4a9e0925d49e/schema)