Formbird API Error Codes - Complete Reference

Document Operations

HTTP Status Code	Error Message	Description
500	Email is taken. Please use another one to create account	Occurs when trying to create an account with an email that's already registered
500	API/Host key is taken. Please use another one to create account	Occurs when trying to create an account with a duplicate API/Host key
500	Public URL is taken. Please use another one to create account	Occurs when attempting to create an account with a URL that's already in use
500	There is a problem with account creation. Please contact administrator and quote error code [code]	Unhandled error during account creation requiring administrator intervention
500	Saving new document failed with: [error]	Database or validation error occurred while saving a new document
500	Error in documents bulk upload: [error message]	Batch upload failed due to invalid JSON format, malformed document structure, or database errors

HTTP Status Code	Error Message	Description
401	No logged in user in call to find	User authentication is missing or invalid for document retrieval
403	Document type restricted	Attempted to access a document type that is restricted from user access
404	Template or document: [id] not found	The requested document or template identifier doesn't exist in the system
410	GONE	The requested resource was previously available but has been permanently removed
500	MongoDB Query could not be converted to ElasticSearch in findAll	Complex query structure cannot be translated to ElasticSearch format
500	Error updating document [id] [err]	Server encountered an error while processing the document update
500	Id not passed to update function	Document identifier was missing in the update request

HTTP Status Code	Error Message	Description
400	Bad update request: Updated document is missing	The request body doesn't contain the document to be updated
401	No logged in user in call to update	Authentication is required but missing for update operation
422	Unprocessable Content	The request payload format is correct but contains invalid content
422	No document for found patchedVersionId [patchedVersionId]	The specified version of document for patching doesn't exist
500	Id not passed to update function	Document identifier is missing in the update request
500	Error updating document: [id]: [error details]	Server encountered an error during document update
500	Saving existing document [id] failed with: [error details]	Failed to save changes to an existing document

HTTP Status Code	Error Message	Description
401	No logged in user in call to destroy	Authentication is required but missing for delete operation
500	Error deleting document: [error details]	Server encountered an error while attempting to delete the document
500	Error undeleting document: [error details]	Failed to restore a previously deleted document

HTTP Status Code	Error Message	Description
400	File type not allowed: [fileType]	The file extension is not in the system's whitelist of permitted file types
500	Error in file upload: [error message]	Generic error during file upload process

HTTP Status Code	Error Message	Description
404	File reference document not found: [fileNo]	The file reference number doesn't exist in the system
500	Field name for files not set in fileReference configuration	System configuration error: missing file field name setting
500	Outdated file reference document or invalid file reference config	File reference document structure is incompatible or corrupted
500	Upload provider did not work properly	File storage service encountered an error