From 30e64b82975782e977d7e8adf03b81c12a597eea Mon Sep 17 00:00:00 2001 From: Jeff Mitchell Date: Tue, 9 Oct 2018 16:54:18 -0400 Subject: [PATCH] Add note about accepting 200 or 204 --- website/source/api/index.html.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/website/source/api/index.html.md b/website/source/api/index.html.md index 6809e6509..627618509 100644 --- a/website/source/api/index.html.md +++ b/website/source/api/index.html.md @@ -195,6 +195,11 @@ The following HTTP status codes are used throughout the API. Vault tries to adhere to these whenever possible, but in some cases may not -- feel free to file a bug in that case to point our attention to it! +~> *Note*: Applications should be prepared to accept both `200` and `204` as +success. `204` is simply an indication that there is no response body to parse, +but API endpoints that indicate that they return a `204` may return a `200` if +warnings are generated during the operation. + - `200` - Success with data. - `204` - Success, no data returned. - `400` - Invalid request, missing or invalid data.