Skip to main content

API Reference

Base endpoint​

The endpoint is region-specific. Use the one for the region your bucket is in:

RegionEndpoint
Europe (France) eu-west-1 (default)https://eu-west-1.s3.fil.one
US East (Michigan) us-east-1https://us-east-1.s3.fil.one

All requests must use HTTPS and authenticate with AWS Signature Version 4 (SigV4). Examples on this page and elsewhere in the docs use eu-west-1 because it is the default region — substitute your own where it differs. Access keys are scoped to a single region and must match the endpoint you call.

Request format​

Fil One accepts standard S3 API requests. Use path-style addressing:

# Path style
https://eu-west-1.s3.fil.one/my-bucket/my-key

Virtual-hosted-style URLs (https://my-bucket.s3.fil.one/my-key) are not supported. Configure your S3 client to use path-style requests (see SDK guides).

Authentication​

Include SigV4 authentication headers in every request. All S3-compatible SDKs handle this automatically when you provide your access key and secret key. See Authentication for setup instructions.

Response format​

Responses follow standard S3 conventions -- XML for list and error responses, raw bytes for object data. All responses include standard S3 headers (x-amz-request-id, ETag, Content-Length, etc.).

Supported operations​

See the S3 Compatibility page for the full list of supported operations.