API Documentation
Errors
This guide provides a breakdown of common errors you might encounter while using the Carbon API. If you encounter an error message not listed here, don’t hesitate to contact our support team for assistance.
Sync Errors
Embeddings
-
Failed to upsert vectors
- Description: Unable to insert vector embeddings into our database.
- Suggested Action: Manually trigger a resync for the file.
-
Failed to generate embeddings
- Description: Failed to create vector embeddings using the embedding model.
- Suggested Action: Manually trigger a resync for the file.
-
File chunking failed: encountered text corresponding to disallowed special token
- Description: Unable to segment text due to unrecognized characters.
- Suggested Action: Review the uploaded file.
-
Mismatch between chunks and embeddings
- Description: Discrepancy in the count of text chunks and embeddings.
- Suggested Action: Contact support for further investigation.
Parsing
No text was retrieved from file
- Description: Unable to extract text from the file.
- Suggested Action: Review the uploaded file to ensure text is present.
Data Connectors
-
Failed to decode Notion response
- Description: Unable to properly process Notion’s response.
- Suggested Action: Review the Notion page.
-
Failed to get Notion files for updating the data source
- Description: Possible permission issue.
- Suggested Action: Verify user access to and content of the Notion page.
-
Notion failed to return the requested blocks
- Description: Possible permission issue or deleted block.
- Suggested Action: Verify user access to the Notion page.
-
Failed to retrieve and parse file
- Description: Notion error due to elements that cannot be parsed.
- Suggested Action: Review the content of Notion page.
-
Failed to auto-sync during scheduled sync
- Description: Unsuccessful file re-sync.
- Suggested Action: Verify the file(s) being synced.
Rate Limit
You have hit one or more rate limits, please try again later
- Description: Exceeded rate limits for the API or a data connector.
- Suggested Action: Implement proper rate limiting practices or wait before retrying.
Authentication
Your auth token has been revoked
- Description: Expired authentication token.
- Suggested Action: Generate a new refresh token for use.