# S3 API Compatibility LLMS index: [llms.txt](/llms.txt) --- This page documents S3 APIs supported by MinIO Object Storage. For reference documentation on any given API, see the corresponding documentation for Amazon S3. > [!WARNING] > **Important** > > MinIO strongly recommends using an [S3-Compatible SDK](/developers/minio-drivers/#minio-drivers) for performing object storage operations. ## Object APIs {#object-apis} - [CopyObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html) - [DeleteObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html) - [DeleteObjects](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjects.html) - **Conditional DELETE:** published Server 20260903 ignores `If-Match`. Server 20260916 supports nonempty `If-Match` on single `DeleteObject` (#145/#178), including addressed-version comparison. Batch `DeleteObjects` still ignores `` and provides no per-item conditional guard. See [scope and limitations](/blog/design/conditional-delete/). - [DeleteObjectTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html) - [GetObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) - [GetObjectAttributes](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html) - [GetObjectTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html) - [HeadObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html) - [ListObjects](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html) - [ListObjectsV2](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html) - [ListObjectVersions](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectVersions.html) - [PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) - [PutObjectTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) - [RestoreObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html) - [SelectObjectContent](https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html) ### Object Locking {#object-locking} - [GetObjectRetention](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html) - [PutObjectRetention](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectRetention.html) - [GetObjectLegalHold](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html) - [PutObjectLegalHold](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLegalHold.html) - [GetObjectLockConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html) - [PutObjectLockConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectLockConfiguration.html) ### Unsupported API Object Endpoints {#unsupported-api-object-endpoints} ```text GetObjectAcl PutObjectAcl ``` ### Multipart Uploads {#multipart-uploads} - [AbortMultipartUpload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html) - [CompleteMultipartUpload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html) - [CreateMultipartUpload](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html) - [ListMultipartUploads](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html) - [ListParts](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html) - [UploadPart](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html) - [UploadPartCopy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html) #### Differences from S3 APIs for Multipart Uploads {#differences-from-s3-apis-for-multipart-uploads} - Published Server 20260903 treats a non-empty `ListMultipartUploads` prefix as an exact object name. An empty prefix uses node-local volatile state without complete pagination, marker or delimiter semantics. - Server 20260916 includes [PR #198](https://github.com/pgsty/silo/pull/198), adding durable discovery, global pagination and continuation after a native marker upload is deleted. The #213 compatibility follow-up defaults to `legacy`, retaining the old limitations; strict mode requires an explicit `MINIO_API_MULTIPART_LISTING=strict` environment setting. Before enabling strict mode, upgrade all writers, drain legacy uploads and validate both the read-only preflight and scan capacity. Strict mode returns 503 for insufficient coverage, legacy records or resource limits. An ordinary upgrade requires neither a mode switch nor forced upload drain. See the [implementation and upgrade contract](/blog/design/list-multipart-uploads/#implementation) for ordering, scan capacity and the cancellation boundary for delayed creation writes. Publication does not establish strict-mode capacity acceptance for a deployment. - The `AbortIncompleteMultipartUpload` lifecycle action is not supported with `PutBucketLifecycle`. ## Bucket APIs {#bucket-apis} - [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html) - [DeleteBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html) - [DeleteBucketEncryption](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html) - [DeleteBucketTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html) - [GetBucketEncryption](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html) - [GetBucketLocation](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLocation.html) - [GetBucketTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html) - [GetBucketVersioning](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html) - [HeadBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html) - [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html) - [ListDirectoryBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListDirectoryBuckets.html) - [PutBucketEncryption](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html) - [PutBucketTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html) - [PutBucketVersioning](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketVersioning.html) ### Bucket Replication {#bucket-replication} - [GetBucketReplication](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html) - [PutBucketReplication](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html) - [DeleteBucketReplication](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html) ### Bucket Lifecycle {#bucket-lifecycle} - [GetBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html) - [GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html) - [PutBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html) - [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html) - [DeleteBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html) ### Bucket Notifications {#bucket-notifications} - [GetBucketNotification](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotification.html) - [GetBucketNotificationConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html) - [PutBucketNotification](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotification.html) - [PutBucketNotificationConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) ### Bucket Policies {#bucket-policies} - [GetBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicy.html) - [GetBucketPolicyStatus](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketPolicyStatus.html) - [PutBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketPolicy.html) - [DeleteBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketPolicy.html) - [GetBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html) - [PutBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html) - [DeleteBucketCors](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html) ### Unsupported API Bucket Operations {#unsupported-api-bucket-operations} ```text GetBucketInventoryConfiguration PutBucketInventoryConfiguration DeleteBucketInventoryConfiguration GetBucketMetricsConfiguration PutBucketMetricsConfiguration DeleteBucketMetricsConfiguration PutBucketWebsite GetBucketLogging PutBucketLogging PutBucketAccelerateConfiguration DeleteBucketAccelerateConfiguration PutBucketRequestPayment DeleteBucketRequestPayment PutBucketAcl HeadBucketAcl GetPublicAccessBlock PutPublicAccessBlock DeletePublicAccessBlock GetBucketOwnershipControls PutBucketOwnershipControls DeleteBucketOwnershipControls GetBucketIntelligentTieringConfiguration PutBucketIntelligentTieringConfiguration ListBucketIntelligentTieringConfigurations DeleteBucketIntelligentTieringConfiguration GetBucketAnalyticsConfiguration PutBucketAnalyticsConfiguration ListBucketAnalyticsConfigurations DeleteBucketAnalyticsConfiguration CreateSession ``` ### MinIO alternatives for unsupported Bucket resources {#minio-alternatives-for-unsupported-bucket-resources} - For calls to `BucketACL` or `ObjectACL` operations, use [Policies](/administration/identity-access-management/policy-based-access-control/#minio-policy). - `BucketCORS` operations are supported since `RELEASE.2026-09-03T13-18-01Z`. A bucket with its own CORS configuration is served only by that configuration; buckets without one use the server-wide `MINIO_API_CORS_ALLOW_ORIGIN` policy, which allows every origin by default. - For calls to `BucketWebsite` operations, use `caddy` or `nginx`. - For calls to `BucketAnalytics`, `BucketMetrics`, or `BucketLogging` operations, use [Bucket Notifications](/administration/monitoring/bucket-notifications/#minio-bucket-notifications).