# Harvey

- [Authentication](https://developers.harvey.ai/api-reference/authentication.md)
- [Rate Limits](https://developers.harvey.ai/api-reference/ratelimits.md)
- [Completion](https://developers.harvey.ai/api-reference/completion/completion.md): Harvey's Completion API provides access to Harvey's models via our orchestration engine, allowing users to ask complex, freeform questions and receive detailed legal-grade responses programmatically. It can also be used in conjunction with files attached to the request, Vaults, and Regional Knowledg…
- [List Vault Projects and Knowledge Bases](https://developers.harvey.ai/api-reference/vault/list-vault-projects-and-knowledge-bases.md): 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.
- [List Vaults in the Recycle Bin](https://developers.harvey.ai/api-reference/vault/list-vaults-in-the-recycle-bin.md): Lists every vault currently in the recycle bin for the current workspace. When a Vault project is deleted it is not purged immediately — it first moves to a workspace recycle bin, where it can be reviewed before being permanently deleted. Entries are ordered by `deleted_at` descending. This endpoint…
- [Get Vault Project Metadata](https://developers.harvey.ai/api-reference/vault/get-vault-project-metadata.md): Fetches metadata for a specified Vault project, including file details and storage limits.
- [Get Review Table Metadata](https://developers.harvey.ai/api-reference/vault/get-review-table-metadata.md): Fetches metadata for a single review table by its ID, including its title, creation timestamp, and the list of file IDs associated with it.
- [Get File Details](https://developers.harvey.ai/api-reference/vault/get-file-details.md): Retrieves details and processing status for one or more files by their IDs. A maximum of 1000 file IDs can be provided per request. This endpoint is useful for checking the processing status of recently uploaded files to determine when they are ready to query. Files that are not found or not accessi…
- [Get Review Table Row Details](https://developers.harvey.ai/api-reference/vault/get-review-table-row-details.md): Enables authorized users to retrieve a row from a review table, given a review table ID and a file ID corresponding to the row.
- [Add Row to Review Table](https://developers.harvey.ai/api-reference/vault/add-row-to-review-table.md): Adds one or more files to an existing review table as new rows and populates each new row's cells for every existing visible column.
- [List Files in a Vault Project](https://developers.harvey.ai/api-reference/vault/list-files-in-a-vault-project.md): Lists files within a single vault project, with filtering and sorting supported.
- [List Project Users](https://developers.harvey.ai/api-reference/vault/list-project-users.md): Lists all workspace users with current active access to a specified Vault project, along with their access levels. Includes effective user access (including inherited access), and the project owner is always included with `MANAGE` access.
- [Update Project Users](https://developers.harvey.ai/api-reference/vault/update-project-users.md): Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request.
- [Remove Project Users](https://developers.harvey.ai/api-reference/vault/remove-project-users.md): Removes direct workspace user shares for specified users (identified by email address) from a Vault project. Only direct `WORKSPACE_USER` shares are removed; inherited access via workspace, group, or space shares is not affected. Per-user validation failures (e.g. unknown email, inactive user, proje…
- [Create a new Vault project](https://developers.harvey.ai/api-reference/vault/create-a-new-vault-project.md): Creates a new project in the Vault system. The project can be designated as a knowledge base.
- [Upload Files to Project](https://developers.harvey.ai/api-reference/vault/upload-files-to-project.md): The Upload Files API endpoint enables organizations to both upload new files and update existing ones within Vault projects. A maximum of 50 files can be uploaded per API request.
- [Semantic search over a vault project](https://developers.harvey.ai/api-reference/vault/semantic-search-over-a-vault-project.md): Performs semantic search over documents in a single vault project. Returns the most relevant text chunks for the given natural-language query. Intended for use by external systems (e.g. a customer's own assistant or LLM) that need to retrieve relevant passages and then generate responses using their…
- [Delete a file from a Vault project](https://developers.harvey.ai/api-reference/vault/delete-a-file-from-a-vault-project.md): Enables authorized organizations to remove an existing file from a Vault project. The endpoint verifies that the file exists and that the requesting user belongs to the file's workspace before proceeding with the deletion. In cases where deletion cannot be immediately completed (for example, if ther…
- [Delete an entire vault project and all its contents](https://developers.harvey.ai/api-reference/vault/delete-an-entire-vault-project-and-all-its-contents.md)
- [Get Usage History](https://developers.harvey.ai/history-export/usage/get-usage-history.md): Fetches the usage history and metadata for a specified time range. Includes query events from your workspace users across Harvey product areas. The data includes basic metadata like user, timestamp and event kind.
- [Get Usage History (v2)](https://developers.harvey.ai/history-export/usage/get-usage-history-v2.md): Fetches the usage history and metadata for a specified time range. Returns enriched event data with product surface area, subsurface details, and additional metadata across Harvey product areas.
- [Get Query History](https://developers.harvey.ai/history-export/queries/get-query-history.md): Fetches the query history and metadata for a specified time range, including sensitive information such as inputs to and outputs from the AI system.
- [Get Query History (v2)](https://developers.harvey.ai/history-export/queries/get-query-history-v2.md): Fetches the query history and metadata for a specified time range, including sensitive information such as inputs to and outputs from the AI system. Returns enriched event data with product surface area, subsurface details, and additional metadata.
- [Search Audit Logs](https://developers.harvey.ai/api-reference/search/search-audit-logs.md): Takes a timestamp as a parameter and returns the audit log at or after the timestamp. Useful to begin pagination to get more logs.
- [Retrieve Earliest Audit Log](https://developers.harvey.ai/api-reference/retrieve/retrieve-earliest-audit-log.md): Returns the earliest audit log for the workspace. Useful to begin pagination to get more logs.
- [Retrieve Latest Audit Log](https://developers.harvey.ai/api-reference/retrieve/retrieve-latest-audit-log.md): Returns the latest audit log for the workspace. Useful to begin pagination to get more logs.
- [Query Audit Logs](https://developers.harvey.ai/api-reference/query/query-audit-logs.md): Paginates forward in time from a given audit log ID. It takes a log ID parameter to begin fetching from and a take parameter for the number of log entries to fetch.
- [Get Client Matters](https://developers.harvey.ai/api-reference/retrieve/get-client-matters.md): Retrieves the full list of client matters in Harvey, including deleted ones, with usage statistics.
- [Add Client Matters](https://developers.harvey.ai/api-reference/add/add-client-matters.md): Deprecated. Use POST /api/v2/clients followed by POST /api/v2/matters for new integrations. See the [Client Matters guide](/guides/client_matters#migrate-from-v1-writes) for migration steps. The v1 GET and DELETE endpoints remain available. When the workspace requires legacy name validation, each na…
- [Delete Client Matters](https://developers.harvey.ai/api-reference/delete/delete-client-matters.md): Soft-deletes client matters by their stored names, preventing future selection. Use name from GET /api/v1/client_matters, not a label or UUID. Inspect success_count and failed even when the response is HTTP 200. Missing names appear in failed. A retry that deletes no active matters can also return r…
- [Upsert Clients](https://developers.harvey.ai/api-reference/upsert/upsert-clients.md): Creates or updates clients using your firm's client identifiers. Submit 1 to 10,000 clients per request.
- [Upsert Matters](https://developers.harvey.ai/api-reference/upsert/upsert-matters.md): Creates or updates matters under existing clients using your firm's client and matter identifiers. Submit 1 to 10,000 matters per request. Uses the delimiter configured for the API token's active workspace, or `.` when none is configured. If the workspace requires an explicit delimiter and none is c…
- [Introduction](https://developers.harvey.ai/guides/introduction.md): Welcome to the Harvey API Guide.
- [Authentication](https://developers.harvey.ai/guides/authentication.md)
- [Assistant](https://developers.harvey.ai/guides/assistant.md): Transform legal workflows with powerful AI-powered reasoning
- [Vault](https://developers.harvey.ai/guides/vault.md): Automate secure document workflows with Vault
- [Review Tables](https://developers.harvey.ai/guides/review_tables.md): Read results from and add rows to Vault review tables
- [History Exports](https://developers.harvey.ai/guides/usage_history.md): Export usage and query history across your organization
- [Audit Logs](https://developers.harvey.ai/guides/audit_logs.md): Query and retrieve audit logs for workspace activity monitoring
- [Audit Log Example](https://developers.harvey.ai/guides/audit-logs-example.md)
- [Client Matters](https://developers.harvey.ai/guides/client_matters.md): Create clients and matters, update their details, and manage billing attribution
- [Harvey MCP](https://developers.harvey.ai/guides/harvey_mcp.md): connect AI assistants to Harvey's legal AI capabilities through MCP.

## OpenAPI Specs

- [audit_logs_api](/audit_logs_api.json)
- [client_matters_api](/client_matters_api.json)
- [history_export_api](/history_export_api.json)
- [v1_completion_api](/v1_completion_api.json)
- [v2_completion_api](/v2_completion_api.json)
- [vault_api](/vault_api.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.