A container for eDiscovery activity related to a specific case or
investigation. A matter includes: saved search queries, a list of accounts
with data on hold, data exports, and a list of the accounts that can access
the matter. A matter is represented by a
Matter resource.
A policy that prevents Google Workspace services from deleting data. Holds
are typically used to preserve data for legal or investigation purposes.
Holds override
retention rules.
A hold is represented by a
Hold resource.
A query that you save in a matter. You can re-run a saved query to get data
that changed since the last the query was run. You can also copy saved
queries and reuse them in other matters. A saved query is represented by a
Saved query resource.
A downloadable set of Google Workspace data that match your search query. An
export is represented by an Export resource.
Next steps
To work with Vault resources, the account must have the
required Vault privileges
and access to the matter. To access a matter, the account must have created
the matter, have the matter shared with them, or have the View All
Matters privilege. For example, to download an export, an account needs
the Manage Exports privilege and the matter shared with them.
To learn about developing with Google Workspace APIs, including handling
authentication and authorization, see
Get started as a Workspace developer.
To learn how to configure and run a simple Vault app, try
a quickstart in Python or
Java.
[null,null,["Last updated 2025-08-28 UTC."],[],[],null,["# Vault API Overview\n\nWith the Vault API, you can manage eDiscovery projects, including the following tasks:\n\n- Create matters and set who has access to them\n- Place data on hold\n- Create and edit saved search queries\n- Start and monitor exports\n\n| **Note:** To set retention rules or audit Vault activity, use the Vault app. For details, see [the Vault Help Center](https://support.google.com/vault#topic=2739742).\n\nThe following is a list of common terms used in the Vault API:\n\n*[Matter](/workspace/vault/reference/rest/v1/matters)*\n: A container for eDiscovery activity related to a specific case or\n investigation. A matter includes: saved search queries, a list of accounts\n with data on hold, data exports, and a list of the accounts that can access\n the matter. A matter is represented by a\n [Matter resource](/workspace/vault/reference/rest/v1/matters#resource:-matter).\n\n*[Hold](/workspace/vault/reference/rest/v1/matters.holds)*\n: A policy that prevents Google Workspace services from deleting data. Holds\n are typically used to preserve data for legal or investigation purposes.\n Holds override\n [retention rules](https://support.google.com/vault/answer/2990828).\n A hold is represented by a\n [Hold resource](/workspace/vault/reference/rest/v1/matters.holds#resource:-hold).\n\n*[Saved search query](/workspace/vault/reference/rest/v1/matters.savedQueries)*\n: A query that you save in a matter. You can re-run a saved query to get data\n that changed since the last the query was run. You can also copy saved\n queries and reuse them in other matters. A saved query is represented by a\n [Saved query resource](/workspace/vault/reference/rest/v1/matters.savedQueries#resource:-savedquery).\n\n*[Export](/workspace/vault/reference/rest/v1/matters.exports)*\n: A downloadable set of Google Workspace data that match your search query. An\n export is represented by an [Export resource](/workspace/vault/reference/rest/v1/matters.exports).\n\nNext steps\n----------\n\n- To work with Vault resources, the account must have the\n [required Vault privileges](https://support.google.com/vault/answer/2799699)\n and access to the matter. To access a matter, the account must have created\n the matter, have the matter shared with them, or have the **View All\n Matters** privilege. For example, to download an export, an account needs\n the **Manage Exports** privilege and the matter shared with them.\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, see\n [Get started as a Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Vault app, try\n a quickstart in [Python](/workspace/vault/quickstart/python) or\n [Java](/workspace/vault/quickstart/java)."]]