# S3-Supported API

The S3 Gateway emulates a subset of the [API exposed by S3](<https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html>). This subset includes all API endpoints relevant to data systems.

> [!TIP]
>
> For more information, see [architecture](<https://docs.lakefs.io/concepts/architecture/index.md#s3-gateway>).

lakeFS supports the following API operations:

1. Identity and authorization

   1. [SIGv2](<https://docs.aws.amazon.com/general/latest/gr/signature-version-2.html>)
   2. [SIGv4](<https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html>)
2. Bucket operations:

   1. [ListBuckets](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html>)
   2. [HEAD bucket](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html>)
3. Object operations:

   1. [DeleteObject](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html>)
   2. [DeleteObjects](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjects.html>)
   3. [GetObject](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html>)

      1. Support for caching headers, ETag
      2. Support for range requests
      3. Support for reading user metadata.
      4. **No** support for [SSE](<https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html>)
      5. **No** support for [SelectObject](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html>) operations
   4. [HeadObject](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html>)
   5. [PutObject](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html>)

      1. Support multi-part uploads
      2. Support for writing user metadata.
      3. **No** support for storage classes
      4. **No** object level tagging
   6. [CopyObject](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html>)
4. Object Listing:

   1. [ListObjects](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html>)
   2. [ListObjectsV2](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html>)
   3. [Delimiter support](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html#API_ListObjectsV2_RequestSyntax>) (for `"/"` only)
5. Multipart Uploads:

   1. [AbortMultipartUpload](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html>)
   2. [CompleteMultipartUpload](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html>)
   3. [CreateMultipartUpload](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html>)
   4. [ListParts](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html>) **Currently supported only on AWS S3.** [Link to tracked issue](<https://github.com/treeverse/lakeFS/issues/7600>)
   5. [ListMultipartUploads](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html>) **Currently supported only on AWS S3.** [Link to tracked issue](<https://github.com/treeverse/lakeFS/issues/8563>)
   6. [Upload Part](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html>)
   7. [UploadPartCopy](<https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html>)
