Issues
When Unstructured tries to process or transfer data, you get one of the following error types:ValidationError: For example,S3ConnectionConfig,PluginResponse, orfiledata_meta input typeerrors.ClientResponseError: For example, anHTTP 422 Unprocessable Entityerror.ListConversionException: For example, for Pinecone, anExpected list, got Noneerror.ServerOperationError: For example, for Databricks, anUNRESOLVED_COLUMNerror.WeaviateDeleteManyError: For example, ano such prop with name 'record_id'error.CollectionInsertManyException: For example, for Astra DB, avector dimension mismatcherror.TypeError: For example, for Pinecone, aPineconeUploader missing argumenterror.UserError: For example, a wrappingschema validation failure.
Possible causes
- The data being processed or transferred doesn’t match the expected structure, format, or validation rules.
- The data provided in configuration or during processing is not valid.
- The data being sent to a destination doesn’t match the destination’s schema—for example, the data has missing fields, wrong data types, or an incorrect number of vector dimensions.
- Incorrect configuration values were provided—for example, a non-string token was provided where a string was expected instead.
- There is a schema mismatch between the data generated by Unstructured and the destination schema—for example, missing columns or properties, or wrong data types.
- The specified embedding model generates vectors of a different dimension than the destination index or collection is configured for.
- The data was generated in an unexpected format.
Possible solutions
- Verify the data configuration: Double-check configuration parameters against the relevant documentation for the correct data format and type.
- Verify the destination schema: Ensure that the schema—including columns, properties, types, and vector dimensions—in the destination’s system matches the data being sent. You might need to update or recreate the destination schema.
- Check the data fields: Check if fields such as
record_id,element_id,text,embeddings, andmetadataare expected and present. - Verify the embedding dimensions: Confirm that the specified embedding model produces vectors of the dimension expected by the destination collection or index.
- Contact Unstructured Support: For
HTTP 422 Unprocessable Entityerrors where the cause isn’t clear,ListConversionExceptionerrors,TypeErrorerrors, or persistent schema mismatch issues after verification, contact Unstructured Support.

