---
title: Common Errors
slug: api/common-errors
description: Learn about the error codes that you may encounter when using the FWS API. From invalid requests to missing authentication details, this document covers various errors and provides necessary information to troubleshoot. Don't hesitate to reach out to Form
createdAt: 2023-07-04T09:16:03.103Z
---

# Errors

The FWS API uses the following common error codes, these errors may be found in any of the responses above:

| HTTP Status Code | Error Code                                    | Description                                                                                                                                                                                                                                                                   |
| ---------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400              | invalid\_request                              | Authorization header is not in expected Bearer token format.                                                                                                                                                                                                                  |
| 400              | invalid\_container\_type                      | The `containerType` provided is not recognized.                                                                                                                                                                                                                               |
| 400              | value\_cannot\_be\_empty                      | Empty label or identifier provided. This error code can also be returned when an empty Code is provided for a Term asset.                                                                                                                                                     |
| 400              | invalid\_assetgroup\_type                     | The `assetGroupType` provided is not recognized.                                                                                                                                                                                                                              |
| 400              | invalid\_workflow\_state                      | The container is not in a editable lifecycle state.                                                                                                                                                                                                                           |
| 400              | invalid\_asset\_type                          | The asset type is not valid for the asset group.                                                                                                                                                                                                                              |
| 400              | invalid\_encoding                             | An invalid encoding type is entered in the “encoding” field.                                                                                                                                                                                                                  |
| 400              | incompatible\_property                        | One of `standardName`, `standardVersion`, or `forSubmission` have been supplied for a non-Dataset Asset Group                                                                                                                                                                 |
| 400              | cannot\_create\_already\_exists               | The specified library version is already associated with the container.                                                                                                                                                                                                       |
| 400              | cannot\_delete\_does\_not\_exist              | The specified library version is not associated with the container and so cannot be removed.                                                                                                                                                                                  |
| 400              | malformed\_json                               | The input JSON request is missing.                                                                                                                                                                                                                                            |
| 400              | file\_not\_found                              | The input file is missing from the request.                                                                                                                                                                                                                                   |
| 400              | unknown\_transform\_type                      | The requested type of transform was not recognized, e.g. it was not Visualization.                                                                                                                                                                                            |
| 400              | conversion\_for\_dataset\_in\_progress        | The type of the specified Asset Group does not support Visualizations e.g. Generic                                                                                                                                                                                            |
| 400              | conversion\_for\_asset\_group\_in\_progress   | A conversion for the specified asset group is already running.                                                                                                                                                                                                                |
| 400              | conversion\_for\_asset\_group\_in\_progress   | A conversion for the specified dataset is already running.                                                                                                                                                                                                                    |
| 400              | no\_data\_for\_download                       | No files were able to be prepared for download for this request.                                                                                                                                                                                                              |
| 400              | invalid\_template\_id                         | Badly formatted templateID                                                                                                                                                                                                                                                    |
| 404              | unknown\_template                             | Template not found for templateID                                                                                                                                                                                                                                             |
| 400              | template\_inactive                            | Template not activated                                                                                                                                                                                                                                                        |
| 400              | change\_request\_custom\_properties\_invalid  | Invalid custom properties for template.                                                                                                                                                                                                                                       |
| 400              | invalid\_container\_aid                       | Badly formatted container AID                                                                                                                                                                                                                                                 |
| 400              | remote\_integration\_error<br />	<br /><br /> | Issue returned by the integration service. A ‘context’ field may also be provided with the error. For example, if authentication details for Rave Web Services are incorrect (e.g. incorrect or expired password), the context will be “Streamed REST call failed with: 401”. |
| 404              | unknown\_container                            | Container not found for AID                                                                                                                                                                                                                                                   |
| 400              | invalid\_asset\_aid                           | Badly formatted asset AID                                                                                                                                                                                                                                                     |
| 400              | invalid\_context\_details                     | Incorrect container or asset details for Template Context                                                                                                                                                                                                                     |
| 401              | invalid\_token                                | Authentication has expired or invalid token information passed.                                                                                                                                                                                                               |
| 401              | ""                                            | Missing authentication details.                                                                                                                                                                                                                                               |
| 404              | unknown\_dataset                              | Could not find any file for the specified asset group AID for given container AID/version pair.                                                                                                                                                                               |
| 404              | unknown\_asset                                | Unknown asset within the container AID/version pair.                                                                                                                                                                                                                          |
| 404              | unknown\_assetgroup                           | Could not find specified Asset Group AID for given container AID/version pair.                                                                                                                                                                                                |
| 404              | unknown\_container                            | Unknown container AID/version pair.                                                                                                                                                                                                                                           |
| 404              | unknown\_source\_container                    | Unknown container AID/version pair for source.                                                                                                                                                                                                                                |
| 404              | invalid\_class\_type                          | `classType` provided for Dataset asset is not one of the required values                                                                                                                                                                                                      |
| 404              | invalid\_comparator                           | `comparator` provided for Question or Selection Criteria asset is not one of the required values                                                                                                                                                                              |
| 404              | invalid\_data\_type                           | `dataType` provided for Question, Variable, Value, Terminology or Method asset is not one of the required values                                                                                                                                                              |
| 404              | invalid\_order\_number                        | A duplicate order number has been included                                                                                                                                                                                                                                    |
| 404              | invalid\_origin\_type                         | `originType` provided for Variable or Value asset is not one of the required values                                                                                                                                                                                           |
| 404              | invalid\_repeat\_type                         | `repeatType` provided for Section asset is not one of the required values                                                                                                                                                                                                     |
| 404              | invalid\_severity                             | `severity` provided for Question asset is not one of the required values                                                                                                                                                                                                      |
| 404              | invalid\_source                               | `source` provided for Variable or Value asset is not one of the required values                                                                                                                                                                                               |
| 404              | invalid\_term\_properties                     | `externalDictionary` and `terms` have both been provided for a Terminology asset.                                                                                                                                                                                             |
| 404              | invalid\_visit\_type                          | `visitType` provided for Visit asset is not one of the required values                                                                                                                                                                                                        |
| 404              | unknown\_asset\_referenced                    | An asset of this type with this aid cannot be found. Returned when an asset attempts to reference a child asset that does not exist, e.g. a Form references a Section but a Section with that aid cannot be found.                                                            |
| 404              | unknown\_assetgroup                           | Unknown asset group within the container AID/Version pair.                                                                                                                                                                                                                    |
| 404              | unknown\_container                            | Unknown container AID/Version pair.                                                                                                                                                                                                                                           |
| 404              | unknown\_transformId                          | Could not find the specified transform.                                                                                                                                                                                                                                       |
| 404              | unknown\_file                                 | The UUID specified does not match any known generated files.                                                                                                                                                                                                                  |
| 404              | file\_checksum\_not\_found                    | A file was found but it had no checksum stored.                                                                                                                                                                                                                               |
| 500              | ""                                            | Unexpected failure in Formedix Web Services / ryze - in the event this error occurs, please contact Formedix.                                                                                                                                                                 |
| 404              | unknown\_change\_request                      | Change Request Not Found for ID                                                                                                                                                                                                                                               |
| 404              | change\_request\_deleted                      | Change request has been deleted                                                                                                                                                                                                                                               |
| 400              | invalid\_change\_request\_state\_uuid         | Change Request State UUID Invalid format.                                                                                                                                                                                                                                     |
| 404              | unknown\_change\_request\_state               | Change Request State not found for UUID                                                                                                                                                                                                                                       |
| 404              | unknown\_user                                 | User specified as owner does not exist                                                                                                                                                                                                                                        |
| 400              | invalid\_approval\_label                      | Invalid Label for specified change request state transition                                                                                                                                                                                                                   |
| 400              | invalid\_user\_id                             | Invalid format for user UUID                                                                                                                                                                                                                                                  |
| 404              | unknown\_user                                 | User not found for given user UUID                                                                                                                                                                                                                                            |
| 404              | approver\_not\_assigned                       | User doesn’t exist on Change Request as an approver                                                                                                                                                                                                                           |
| 400              | change\_request\_already\_approved            | Trying to remove a user that has already approved change request transition                                                                                                                                                                                                   |
| 404              | unknown\_change\_request\_state               | Change request state not found for UUID                                                                                                                                                                                                                                       |

