Object Storage

Create bucket

Create a new S3-compatible bucket. Bucket names are globally unique and must follow S3 naming rules.

post/v1/object-storage/buckets

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/object-storage/buckets
  • Auth: HTTP bearer

Request body

bucket_namestring required

Globally unique bucket name (S3 naming rules apply)

location_codestring required

Location code

Example request

{
  "bucket_name": "my-app-uploads",
  "location_code": "FIN-03"
}

Response

Newly created bucket

idstring required

Unique identifier of the bucket

namestring required

Globally unique bucket name

object_countnumber

Number of objects stored in the bucket

size_gbnumber

Total size of all objects in GB

created_atstring date-time required

When the bucket was created

Example response

{
  "id": "7dfc2631-0158-4f74-93f6-6b46dcb90fef",
  "name": "my-app-uploads",
  "object_count": 42,
  "size_gb": 1,
  "created_at": "2024-01-15T14:10:27.114Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.