Skip to main content
When you make a document generation request, it might fail at the request stage or during document generation.

​
Request stage errors

While request failures are rare, the following table describes possible error scenarios and how to troubleshoot them.
Response codeTypeIssueSolution
200SuccessDoc Gen accepted the request for processing.No action needed. Processing is in progress.
400ErrorInvalid folder ID, output type, input source, or JSON format.Verify that you include a valid folder ID, output type, input source, and JSON data format.
401ErrorUnauthorized request.Verify that you have access to the file.
403ErrorAccess denied to the content or resource.Verify that you have access to the file and folder specified in the request.
404ErrorThe template file doesn’t exist.Verify that the specified template file exists.
429ErrorToo many requests.See the rate limit guide for information about request limits.

​
Document generation stage errors

After Doc Gen validates the request and initiates document generation, failures can occur during processing. To troubleshoot these errors:
  1. Check the status of the document generation activity.
  2. View the activity details for the failed request.
  3. Review the error information and JSON data used in the request.

​
Box security limitations

If document generation fails due to access restrictions, verify that Box Shield classification policies are configured correctly. Doc Gen requires access to templates to generate documents. If a Box Shield classification policy restricts access to a template, document generation will fail. For more context, see Box security limitations.