Skip to main content
Effective Date — May 7, 2026
As part of the IAM hierarchy simplification, a new format of the TIR APIs is now available. All endpoints that previously included /teams/:team_id segment will now follow a service-centric structure, with project_id now passed as a query parameter instead of a path segment. You can read more about this change

Create Block Storage

Create a dataset of either kind. storage_type selects which:

  • managed — Object Storage backed by a new EOS bucket created for you.
  • e2e_s3 — Object Storage backed by an EOS bucket you already have.
  • pvc — Block Storage backed by a disk of the size you allocate.

Encryption is optional and is set at creation only. Object storage supports E2E-managed (sse-kms) and user-managed (sse-c) keys; disks support sse-kms only.

object_lock_enable and versioning_enable apply to a new managed bucket only. Object lock cannot be enabled after creation, and enabling it turns versioning on permanently.

POST/datasets/

Query parameters

  • project_idQueryintegerrequired

    Project ID

  • active_iamQueryintegeroptional

    Active IAM ID (To access contact person account) Find your Active IAM ID here

  • locationQuerystringrequired

    Location

Request body

application/json

object
namestringrequired

Name of the dataset

storage_typestringrequiredmanaged | e2e_s3 | pvc

Type of storage for the dataset

pvcobject

PVC configuration, required if storage_type is pvc

bucketobject

Bucket configuration, required if storage_type is e2e_s3

access_keyobject

Access key configuration, required if storage_type is e2e_s3

encryption_enableboolean

Whether to enable encryption

encryption_typestringsse-kms | sse-c

Type of encryption to use (required if encryption_enable is true):

  • sse-kms: Server-side encryption with KMS (E2E managed)
  • sse-c: Server-side encryption with customer-provided keys (user managed)
descriptionstring

Optional description of the dataset

Responses

201Success response indicating that the dataset was created.
object
codeinteger

HTTP status code for the operation.

example201
dataobject
errorsobject

Any errors encountered during the operation.

messagestring

Message indicating the result of the operation.

exampleCreated Successfully