Swan Sauvegrain
04/17/2026, 7:47 AMkapa.ai
04/17/2026, 7:50 AMformat field: If you're on source-s3 v4.0.4+, the streams.*.format field is now required. If you're configuring via the API without providing it, you may hit config validation errors. [S3 Migration Guide]
2. Invalid endpoint format: If you're specifying a custom endpoint (e.g., s3.us-east-1.amazonaws.com without the https:// prefix), this can cause failures. On Airbyte Cloud, the endpoint must be secure and not start with http://. [S3 Migration Guide]
3. Legacy config migration: If you upgraded to source-s3 v4.0.0+, the config format changed significantly (e.g., streams array is now required). If you modified the config before running a sync post-upgrade, you may need to manually update the fields to match the new format. [S3 Migration Guide] Recommended next steps ⢠Double-check that your stream configuration includes a valid format object (e.g., {"filetype": "csv"}).
⢠Ensure the Bucket field contains only the bucket name, not a path (paths should go in Globs).
⢠If you're using the API, verify your config matches the v4 schema with a streams array.
If the issue persists, I'd recommend reaching out to Airbyte support with the full connector version and your configuration (with secrets redacted), as the knowledge sources don't contain a direct match for this specific error message. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Swan Sauvegrain
04/17/2026, 7:53 AMkapa.ai
04/17/2026, 7:53 AMdelimiter: str = Field(
default=",",
min_length=1,
description="The character delimiting individual cells in the CSV data. This may only be a 1-character string. For tab-delimited data enter '\\t'.",
order=0,
)
The description explicitly states: "This may only be a 1-character string." A double pipe (||) is two characters, which would fail this validation constraint (min_length=1 combined with the single-character requirement), and would likely cause the stream config object creation to fail.
To fix this, you would need to use a single-character delimiter. If your data uses || as a separator, unfortunately the S3 CSV connector does not support multi-character delimiters. You would need to either:
⢠Pre-process your files to use a single-character delimiter (e.g., |), or
⢠Use a different file format if possible.
The knowledge sources do not provide a workaround for multi-character delimiters within the connector itself. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Swan Sauvegrain
04/17/2026, 8:20 AMkapa.ai
04/17/2026, 8:21 AM.zip, then uses a ZipFileHandler to parse the archive's central directory and list the inner files. [stream_reader.py] Potential issue: Invalid or corrupt ZIP There is a known bug where if a .zip file is corrupt or not a valid ZIP archive, the connector can crash with a TypeError (which could surface as an HTTP 500). A fix was implemented to handle this more gracefully by skipping invalid ZIP files with a warning. [fix PR]
To check: Verify that your ZIP file is a valid, non-corrupt archive by opening it locally. Things to verify 1. ZIP file validity: Confirm the ZIP file can be extracted locally without errors.
2. File naming: Ensure the file ends with .zip (not a compound extension like .csv.zip, which has a separate known bug in source-gcs but not source-s3). [GCS issue]
3. Inner file format: Make sure the CSVs inside the ZIP are valid and match the format configuration (including your delimiter).
4. Connector version: Make sure you're on a recent version of the S3 connector that includes the invalid ZIP handling fix.
Unfortunately, the knowledge sources don't contain enough detail to pinpoint the exact cause of your HTTP 500 during schema refresh. If the issue persists after verifying the above, I'd recommend checking the full server-side logs or opening a support ticket with Airbyte. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Swan Sauvegrain
04/17/2026, 8:56 AMStreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 1209] (through reference chain: io.airbyte.config.ConfiguredAirbyteCatalog["streams"]->java.util.ArrayList[0]->java.util.ArrayList[0]->io.airbyte.config.Field["name"])."kapa.ai
04/17/2026, 9:01 AMSwan Sauvegrain
04/17/2026, 9:15 AMStreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 1209] (through reference chain: io.airbyte.config.ConfiguredAirbyteCatalog["streams"]->java.util.ArrayList[0]->java.util.ArrayList[0]->io.airbyte.config.Field["name"])."Swan Sauvegrain
04/17/2026, 9:19 AMkapa.ai
04/17/2026, 9:19 AMSwan Sauvegrain
04/17/2026, 9:20 AMStreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 1209] (through reference chain: io.airbyte.config.ConfiguredAirbyteCatalog["streams"]->java.util.ArrayList[0]->java.util.ArrayList[0]->io.airbyte.config.Field["name"])."kapa.ai
04/17/2026, 9:20 AMKotlinInvalidNullException for a null name field in io.airbyte.config.Field).
However, the error message is clear about what's happening: during sync initialization, Airbyte is trying to deserialize your ConfiguredAirbyteCatalog and one of the Field objects in your stream configuration has a null value for its name property, which is defined as non-nullable in the Airbyte config model.
This is conceptually similar to a known class of issues where null values in catalog/stream configuration fields cause NPEs or Kotlin null-safety exceptions during initialization. [NPE fix PR] What to try 1. Refresh your schema again and re-save the connection. It's possible the catalog stored for your connection has a malformed field entry (e.g., a field with a blank or missing name, possibly introduced during the earlier schema refresh issues you experienced).
2. Reset the connection: Delete and re-create the connection from scratch. This forces Airbyte to re-discover the catalog cleanly.
3. Check your CSV headers: Since the error points to a Field with a null name, it's worth verifying that none of your CSV files inside the ZIP have empty or missing column headers ā these could be getting picked up as unnamed fields during schema inference.
4. Check your Airbyte version: If you're on an older platform version, there may be known bugs around null field handling that have since been patched.
Unfortunately, the knowledge sources don't contain a direct fix or workaround for this exact error. If the above steps don't resolve it, I'd recommend opening a support ticket or posting in the Airbyte Community Slack with your connector version and platform version. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.kapa.ai
04/17/2026, 9:20 AMSwan Sauvegrain
04/17/2026, 10:17 AMkapa.ai
04/17/2026, 10:17 AMnewlines_in_values) option controls whether newline characters are permitted inside CSV field values. [CSV spec]
In your S3 source CSV format settings, set:
⢠Allow Newlines in Values ā true
> ā ļø Note: The documentation warns that enabling this option may affect performance. [S3 file format settings]
This is the standard supported workaround for line breaks inside CSV text fields. After enabling it, try refreshing your schema again. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.Swan Sauvegrain
04/17/2026, 10:32 AMkapa.ai
04/17/2026, 10:32 AMnewlines_in_values) field is defined in the legacy CSV spec file, which is part of the older (pre-v4) connector code. [CSV spec]
When the connector was migrated to v4.0.0 (using the file-based CDK), the configuration UI was significantly revamped. [S3 Migration Guide] The new v4 CSV format settings documented in the official docs list these options: [S3 file format settings]
⢠Header Definition, Delimiter, Double Quote, Encoding, Escape Character, False Values, Null Values, Quote Character, Skip Rows After/Before Header, Strings Can Be Null, True Values
"Allow Newlines in Values" is not listed among the v4 format settings, which suggests it may have been dropped from the UI in the v4 migration.
The knowledge sources do not contain enough information to confirm definitively whether this option is still available under the hood in v4 or has been fully removed. I'd recommend:
1. Checking the Airbyte S3 connector changelog for any mention of this option being deprecated.
2. Posting in the Airbyte Community to ask if there's an equivalent workaround in v4. š 0 button š 0 button ā¹ļø Tip: Mention @kapa.ai in the thread for follow-ups or DM the app for 1-to-1 help.