Conventional HTTP response codes indicate the success or failure of an API request:
- 2xx codes indicate success.
- 4xx codes indicate a failure due to the information provided, such as an omitted required parameter or incorrect permissions.
- 5xx codes indicate an error with Workiva's servers.
|400||Bad Request||The request was unacceptable, often due to missing a required parameter|
|401||Unauthorized||No valid API token provided|
|403||Forbidden||The API token doesn't have permissions to perform the request|
|404||Not Found||The requested resource doesn't exist|
|409||Conflict||The request conflicts with another request|
|422||Unprocessable Entity||The request is well formed, but the server was unable to process the request|
|429||Too Many Requests||Too many requests too quickly, recommend backoff|
|500||Internal Server Error||Something went wrong on Workiva's end|
|error||string||false||A server-defined error|
|error_description||string||false||Additional details of the error|