{"_id":"553591ce63cc650d0031292e","user":"55356ede6040a20d00454508","__v":9,"project":"55357364e02d480d0003c6d3","category":{"_id":"553591cd63cc650d00312926","__v":1,"pages":["553591ce63cc650d00312929","553591ce63cc650d0031292a","553591ce63cc650d0031292b","553591ce63cc650d0031292c","553591ce63cc650d0031292d","553591ce63cc650d0031292e","553591ce63cc650d0031292f","553591ce63cc650d00312930"],"project":"55357364e02d480d0003c6d3","version":"553591cd63cc650d00312925","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-04-20T21:45:09.762Z","from_sync":false,"order":0,"slug":"api","title":"API"},"version":{"_id":"553591cd63cc650d00312925","project":"55357364e02d480d0003c6d3","__v":13,"forked_from":"55357365e02d480d0003c6d6","createdAt":"2015-04-20T23:54:53.134Z","releaseDate":"2015-04-20T23:54:53.134Z","categories":["553591cd63cc650d00312926","553591cd63cc650d00312927","5536e4d39f7f2d0d00b1cd54","5536e55c20d5ca0d0001580a","5536e6bf7fe60f0d000fd1c0","5536f5bba171250d00c00556","553a974369c2630d00a8562e","553a97c60074c80d00621c2a","553a98332af5f20d000fc32a","553a9b9869c2630d00a85642","556e0f23d02e0b190042f13d","563249b1dcc27a1700823650","5639113f049e420d00476b03","59a5dd94aaa11d003334edb4"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-04-20T22:47:25.398Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"The GoFormz API uses standard HTTP response codes to indicate whether or not a request has succeeded or failed.  \n\nIn addition to the HTTP response code all errors include a JSON Error object in the body of the response which includes additional details about the error that occurred. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"HTTP Status Codes\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Text\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"200\",\n    \"0-1\": \"OK\",\n    \"0-2\": \"Success\",\n    \"1-0\": \"201\",\n    \"1-1\": \"Created\",\n    \"1-2\": \"The resource has been created, the newly created resource can be referenced by the URI(s) returned in the response.\",\n    \"2-2\": \"The request has been accepted for processing, but the processing has not been completed. The request might or might not eventually be acted upon, as it might be disallowed when processing actually takes place.   \\nThe status of the request can be queried by calling GET on the returned URI.\",\n    \"3-2\": \"There was no new data to return.\",\n    \"4-2\": \"The request was invalid or cannot be otherwise served.\",\n    \"5-2\": \"Authentication credentials were missing or incorrect.  This could also occur if the account is not authorized for API access.\",\n    \"6-2\": \"The request is understood, but it has been refused or access is not allowed.  This could occur if the user does not have appropriate permissions for the requested action.\",\n    \"2-0\": \"202\",\n    \"2-1\": \"Accepted\",\n    \"3-0\": \"304\",\n    \"3-1\": \"Not Modified\",\n    \"4-0\": \"400\",\n    \"4-1\": \"Bad Request\",\n    \"5-0\": \"401\",\n    \"5-1\": \"Unauthorized\",\n    \"6-0\": \"403\",\n    \"6-1\": \"Forbidden\",\n    \"7-2\": \"The URI requested is invalid or the resource requested, such as a form, does not exist.\",\n    \"8-2\": \"Returned by the API when an invalid format is specified in the request.\",\n    \"9-2\": \"The request entity has a media type which the server or resource does not support.\",\n    \"10-2\": \"Returned when the body of a request is well formed but fails validation.  For example: updating a non-editable field.\",\n    \"11-2\": \"Returned when a user has sent too many requests in a given amount of time.\",\n    \"12-2\": \"An unexpected error has occurred.  Contact support with the provided requestId for more details.\",\n    \"13-2\": \"The API servers are down or being upgraded.\",\n    \"7-0\": \"404\",\n    \"7-1\": \"Not Found\",\n    \"8-0\": \"406\",\n    \"8-1\": \"Not Acceptable\",\n    \"9-0\": \"415\",\n    \"9-1\": \"Unsupported Media Type\",\n    \"10-0\": \"422\",\n    \"10-1\": \"Unprocessable Entity\",\n    \"11-0\": \"429\",\n    \"11-1\": \"Too Many Requests\",\n    \"12-0\": \"500\",\n    \"12-1\": \"Internal Server Error\",\n    \"13-0\": \"502\",\n    \"13-1\": \"Bad Gateway\"\n  },\n  \"cols\": 3,\n  \"rows\": 14\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Error Object\"\n}\n[/block]\nThe error object returned has the following properties\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"code\",\n    \"0-1\": \"`int`\",\n    \"0-2\": \"The HTTP status code of the error response\",\n    \"1-0\": \"status\",\n    \"1-1\": \"`string`\",\n    \"1-2\": \"A friendly status of the HTTP status Code\",\n    \"2-2\": \"A developer friendly message about the error\",\n    \"3-2\": \"The URL of the request\",\n    \"4-2\": \"A unique ID for this request -helpful for troubleshooting (see below)\",\n    \"2-1\": \"`string`\",\n    \"2-0\": \"message\",\n    \"3-0\": \"requestUrl\",\n    \"3-1\": \"`string`\",\n    \"4-0\": \"requestId\",\n    \"4-1\": \"`string`\"\n  },\n  \"cols\": 3,\n  \"rows\": 5\n}\n[/block]\nSample Error Object:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"code\\\": 400,\\n  \\\"status\\\": \\\"Bad Request\\\",\\n  \\\"message\\\": \\\"'invalid property name' is not a valid sort parameter\\\",\\n  \\\"requestUrl\\\": \\\"https://api.goformz.com/v2/groups?sort=invalid%20property%20name\\\",\\n  \\\"requestId\\\": \\\"d3f40ec7-f9fbe524-4a38-8fbd-6b15ec67\\\"\\n}\\n\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Using the Request Id for additional API support\"\n}\n[/block]\nThe JSON Error object response contains a `requestId` property which is used to associate errors in the API with the specific request that was made.  \n\nIn the rare situation that a `500` (Internal Server Error) response code is received, please  email [support:::at:::goformz.com](mailto:support@goformz.com?Subject=Internal Server Error received in the GoFormz API) and include value of the `requestId` in the body of the email.  \n\nIncluding the `requestId` in the email to [support@goformz.com](mailto:support@goformz.com?Subject=Internal Server Error received in the GoFormz API)  lets our Support Team better track down the specific problem you are receiving.","excerpt":"","slug":"errors","type":"basic","title":"Errors"}
The GoFormz API uses standard HTTP response codes to indicate whether or not a request has succeeded or failed. In addition to the HTTP response code all errors include a JSON Error object in the body of the response which includes additional details about the error that occurred. [block:api-header] { "type": "basic", "title": "HTTP Status Codes" } [/block] [block:parameters] { "data": { "h-0": "Code", "h-1": "Text", "h-2": "Description", "0-0": "200", "0-1": "OK", "0-2": "Success", "1-0": "201", "1-1": "Created", "1-2": "The resource has been created, the newly created resource can be referenced by the URI(s) returned in the response.", "2-2": "The request has been accepted for processing, but the processing has not been completed. The request might or might not eventually be acted upon, as it might be disallowed when processing actually takes place. \nThe status of the request can be queried by calling GET on the returned URI.", "3-2": "There was no new data to return.", "4-2": "The request was invalid or cannot be otherwise served.", "5-2": "Authentication credentials were missing or incorrect. This could also occur if the account is not authorized for API access.", "6-2": "The request is understood, but it has been refused or access is not allowed. This could occur if the user does not have appropriate permissions for the requested action.", "2-0": "202", "2-1": "Accepted", "3-0": "304", "3-1": "Not Modified", "4-0": "400", "4-1": "Bad Request", "5-0": "401", "5-1": "Unauthorized", "6-0": "403", "6-1": "Forbidden", "7-2": "The URI requested is invalid or the resource requested, such as a form, does not exist.", "8-2": "Returned by the API when an invalid format is specified in the request.", "9-2": "The request entity has a media type which the server or resource does not support.", "10-2": "Returned when the body of a request is well formed but fails validation. For example: updating a non-editable field.", "11-2": "Returned when a user has sent too many requests in a given amount of time.", "12-2": "An unexpected error has occurred. Contact support with the provided requestId for more details.", "13-2": "The API servers are down or being upgraded.", "7-0": "404", "7-1": "Not Found", "8-0": "406", "8-1": "Not Acceptable", "9-0": "415", "9-1": "Unsupported Media Type", "10-0": "422", "10-1": "Unprocessable Entity", "11-0": "429", "11-1": "Too Many Requests", "12-0": "500", "12-1": "Internal Server Error", "13-0": "502", "13-1": "Bad Gateway" }, "cols": 3, "rows": 14 } [/block] [block:api-header] { "type": "basic", "title": "Error Object" } [/block] The error object returned has the following properties [block:parameters] { "data": { "h-0": "Name", "h-1": "Type", "h-2": "Description", "0-0": "code", "0-1": "`int`", "0-2": "The HTTP status code of the error response", "1-0": "status", "1-1": "`string`", "1-2": "A friendly status of the HTTP status Code", "2-2": "A developer friendly message about the error", "3-2": "The URL of the request", "4-2": "A unique ID for this request -helpful for troubleshooting (see below)", "2-1": "`string`", "2-0": "message", "3-0": "requestUrl", "3-1": "`string`", "4-0": "requestId", "4-1": "`string`" }, "cols": 3, "rows": 5 } [/block] Sample Error Object: [block:code] { "codes": [ { "code": "{\n \"code\": 400,\n \"status\": \"Bad Request\",\n \"message\": \"'invalid property name' is not a valid sort parameter\",\n \"requestUrl\": \"https://api.goformz.com/v2/groups?sort=invalid%20property%20name\",\n \"requestId\": \"d3f40ec7-f9fbe524-4a38-8fbd-6b15ec67\"\n}\n", "language": "json" } ] } [/block] [block:api-header] { "type": "basic", "title": "Using the Request Id for additional API support" } [/block] The JSON Error object response contains a `requestId` property which is used to associate errors in the API with the specific request that was made. In the rare situation that a `500` (Internal Server Error) response code is received, please email [support@goformz.com](mailto:support@goformz.com?Subject=Internal Server Error received in the GoFormz API) and include value of the `requestId` in the body of the email. Including the `requestId` in the email to [support@goformz.com](mailto:support@goformz.com?Subject=Internal Server Error received in the GoFormz API) lets our Support Team better track down the specific problem you are receiving.