Error Handling
Stay organized with collections
Save and categorize content based on your preferences.
These are the error codes you might get when using the Vault API, how to
interpret them, and what to do when you get them.
If you need more help with an error, review the support resources.
| Error code |
Description |
Action |
| 400: Bad Request |
This error code is returned when there is an error in the input request. |
Check the request, make required changes to the request, and try again. |
| 401: Invalid Credentials |
The access token is invalid or expired. |
Refresh the access token and try again. |
| 404 |
The specified resource was not found. This error code is returned when the
request has a matter, hold, or account that doesn't exist. |
|
| 409 |
The specified resource already exists. |
Try to get the resource again, and, if needed, perform an update. |
| 429 |
The request exceeds a Vault API quota. |
Review the Vault API usage limits and use
an exponential backoff algorithm as described on that page. |
| 500 |
An unexpected error happened while processing the request. |
Retry with exponential backoff. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[],[],null,["# Error Handling\n\nThese are the error codes you might get when using the Vault API, how to\ninterpret them, and what to do when you get them.\nIf you need more help with an error, review the [support resources](/workspace/vault/support).\n\n| **Error code** | **Description** | **Action** |\n|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------|\n| 400: Bad Request | This error code is returned when there is an error in the input request. | Check the request, make required changes to the request, and try again. |\n| 401: Invalid Credentials | The access token is invalid or expired. | Refresh the access token and try again. |\n| 404 | The specified resource was not found. This error code is returned when the request has a matter, hold, or account that doesn't exist. | |\n| 409 | The specified resource already exists. | Try to get the resource again, and, if needed, perform an update. |\n| 429 | The request exceeds a Vault API quota. | Review the [Vault API usage limits](/workspace/vault/limits) and use an exponential backoff algorithm as described on that page. |\n| 500 | An unexpected error happened while processing the request. | Retry with exponential backoff. |"]]
