Guides

S3-compatible storage

Use standard S3 SDKs with Nyas Storage.

Connect an S3 client

Nyas Storage accepts AWS Signature Version 4 requests from standard S3 SDKs and tools. Create a scoped access key in the console under a project's Storage → S3 page.

Endpoint
https://storage.stage.nyas.io/v1/s3
Region
ap-south-1
Authentication
AWS Signature Version 4

Credentials

The secret access key is returned only when a credential is created. Store it outside source control. Grant read, write, and delete permissions independently and set an expiry when practical.

SDK configuration

Set the custom endpoint, region, access key ID, and secret access key. Nyas accepts path-style and virtual-hosted addressing; path-style is the most portable choice for custom endpoints.

TypeScript
const s3 = new S3Client({
  endpoint: "https://storage.stage.nyas.io/v1/s3",
  region: "ap-south-1",
  forcePathStyle: true,
  credentials: { accessKeyId, secretAccessKey },
});

Supported operations

WorkflowS3 operations
ObjectsPutObject, GetObject, HeadObject, DeleteObject
ListingListObjectsV2
Presigned requestsPresigned GET and PUT URLs
Multipart uploadsCreate, upload parts, complete, and abort

Addressing styles

Path-style requests place the bucket in the URL path. Virtual-hosted requests place it in the hostname. Use the endpoint and addressing behavior returned with newly created credentials.

Limitations

Bucket policies, ACLs, object versioning, lifecycle rules, and object tagging are not currently implemented. Signed request timestamps must remain within the accepted clock-skew window.