Overview

Understanding how errors are structured and returned by the Fireflies API is key to effectively handling and troubleshooting issues. This page outlines the common error format and details specific error types.

Error schema

Our GraphQL API follows a standard format for returning errors. Errors are encapsulated within an errors array in the response body. Please visit Error codes to view explanations for error code types
message
String
required
Description of the error
code
String
required
Error code.
friendly
Boolean
required
friendly === true are safe to show to the frontend client. Unfriendly errors may have technical details that may not be useful to the UI layer.
extensions
Object
Contains useful metadata related to the error
Example
{
  "data": {},
  "errors": [
    {
      "message": "Error description",
	  "friendly": true,
      "code": "error_code",
      "extensions": {
        "code": "error_code",
        "status": http_status_code,
		... otherFields
      }
    }
  ]
}

Additional Resources