Errors
This page documents the various error types you may encounter when working with the Mixpeek API, and provides guidance on how to handle and resolve them.
Error Response Format
All Mixpeek API errors follow a consistent JSON response format:
Common Errors and Solutions
Error Type | Common Cause | Solution |
---|---|---|
NotFoundError | Resource ID doesn’t exist or was deleted | Verify IDs and check if the resource was deleted |
ValidationError | Invalid data format or missing required fields | Check the API documentation for required fields and formats |
TooManyRequestsError | Rate limit exceeded | Implement backoff with the provided retry_after value |
FeatureExtractionError | Content format issue or corrupted file | Verify file integrity and ensure it matches supported formats |
MimeTypeError | Unsupported file type | Convert to a supported format listed in the docs |
S3StorageError | Network issues or file size too large | Check network connection and file size limits |
TimeoutError | Operation took too long to complete | Break large operations into smaller batches |
HTTP Errors
These errors represent standard HTTP status code errors.
Common Causes:
- Missing required fields
- Invalid parameter formats
- Logical errors in the request
Resolution:
- Check your request payload against the API documentation
- Ensure all required fields are included
- Verify parameter formats (IDs, dates, etc.)
Processing Errors
Content Format and Validation Errors
Errors related to invalid input data or format issues:
Error Code | Description | Resolution |
---|---|---|
INVALID_FORMAT | File format not supported or corrupted | Verify file is in a supported format and not corrupted |
SCHEMA_VALIDATION | Object does not match bucket schema | Check object structure against bucket schema requirements |
EXCEEDED_SIZE | File size exceeds allowed maximum | Reduce file size or request increased limits |
MALFORMED_JSON | Invalid JSON structure in metadata or config | Validate JSON structure before submission |
MISSING_REQUIRED | Required field or property is missing | Add all required properties to the request payload |
Storage Errors
Raw Data Storage Issues
Errors related to bucket operations and object storage:
Error Code | Description | Resolution |
---|---|---|
BUCKET_NOT_FOUND | Referenced bucket does not exist | Verify bucket ID or create the bucket |
OBJECT_NOT_FOUND | Referenced object does not exist | Check object ID and bucket path |
DUPLICATE_OBJECT | Object with same ID already exists | Use unique object IDs or update existing object |
BLOB_UPLOAD_FAILED | Failed to upload blob to storage | Check network connection and retry |
PREFIX_INVALID | Object prefix format is invalid | Use valid path format for prefix |
Database Errors
Errors related to database operations.
Qdrant Vector Database Issues
Errors related to vector database operations:
Error Code | Description | Resolution |
---|---|---|
VECTOR_INSERT_FAILED | Failed to insert vectors into database | Check vector format and dimensions |
INDEX_CREATION_FAILED | Failed to create search index | Verify index configuration parameters |
INVALID_VECTOR_DIMENSION | Vector dimensions don’t match configured space | Ensure vectors match the expected dimension count |
VECTOR_QUERY_FAILED | Search query operation failed | Check query syntax and parameters |
COLLECTION_CONFIG_ERROR | Vector collection configuration issue | Review collection settings and recreate if needed |
Workflow Errors
Errors related to workflow orchestration and pipeline execution.
Data Processing Pipeline Issues
Errors related to pipeline execution and processing:
Error Code | Description | Resolution |
---|---|---|
PIPELINE_CONFIG_INVALID | Invalid pipeline configuration | Check pipeline configuration syntax and components |
STAGE_EXECUTION_FAILED | Specific pipeline stage failed | Review logs for the failing stage |
INPUT_VALIDATION_FAILED | Pipeline input validation error | Ensure inputs match pipeline requirements |
PIPELINE_TIMEOUT | Pipeline execution timed out | Optimize processing or break into smaller pipelines |
DEPENDENCY_MISSING | Required pipeline dependency not found | Install or configure missing dependencies |
Resolution:
- Check pipeline configuration
- Review task logs for specific failure points
- Verify input data meets pipeline requirements
Contacting Support
If you encounter persistent errors or need help troubleshooting specific issues, contact our support team with the following information:
Was this page helpful?