Skip to content
DocsOpenAPI spec

    Update Bucket

    PATCH/v1/storage/buckets/{bucket_id}

    Update a Bucket’s tags. A Bucket’s name is its S3 name and cannot be changed.

    Path ParametersExpand Collapse
    bucket_id: string
    Body ParametersJSONExpand Collapse
    tags: optional array of string

    Tags to attach to the Bucket.

    ReturnsExpand Collapse
    Bucket object { id, created_at, endpoint, 10 more }

    Bucket details.

    id: string

    Unique identifier for the Bucket.

    created_at: string

    When the Bucket was created.

    formatdate-time
    endpoint: string

    S3 endpoint of the Bucket’s region. Point S3 clients at it, with an Object Storage Key of the same project and region.

    name: string

    Name of the Bucket, used to address it over S3.

    object_count: number

    Number of objects in the Bucket. Updated periodically, so it can lag behind recent writes.

    project_id: string

    Project ID the Bucket belongs to.

    region: RegionName

    Region the resource is in.

    One of the following:
    "us-sva-2"
    "us-wdc-1"
    signing_region: string

    Region S3 clients must sign their requests for (the SigV4 region). Configure it as the region of any S3 client or SDK used with the Bucket.

    size_bytes: number

    Total size of the objects in the Bucket, in bytes. Updated periodically, so it can lag behind recent writes.

    Status of the resource.

    One of the following:
    "pending"
    "creating"
    "updating"
    "ready"
    "deleting"
    "deleted"
    "error"
    "suspended"
    tags: array of string

    Tags attached to the Bucket.

    updated_at: string

    When the Bucket was updated.

    formatdate-time
    url: string

    Path-style URL of the Bucket.

    Update Bucket

    curl https://api.nirvanalabs.io/v1/storage/buckets/$BUCKET_ID \
        -X PATCH \
        -H 'Content-Type: application/json' \
        -H "Authorization: Bearer $NIRVANA_LABS_API_KEY" \
        -d '{
              "tags": [
                "production",
                "ethereum"
              ]
            }'
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-01-01T00:00:00Z",
      "endpoint": "https://s3.sva2.nirvanacloud.io",
      "name": "my-bucket",
      "object_count": 1024,
      "project_id": "123e4567-e89b-12d3-a456-426614174000",
      "region": "us-sva-2",
      "signing_region": "us-east-1",
      "size_bytes": 1073741824,
      "status": "ready",
      "tags": [
        "production",
        "ethereum"
      ],
      "updated_at": "2025-01-01T00:00:00Z",
      "url": "https://s3.sva2.nirvanacloud.io/my-bucket"
    }
    Returns Examples
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-01-01T00:00:00Z",
      "endpoint": "https://s3.sva2.nirvanacloud.io",
      "name": "my-bucket",
      "object_count": 1024,
      "project_id": "123e4567-e89b-12d3-a456-426614174000",
      "region": "us-sva-2",
      "signing_region": "us-east-1",
      "size_bytes": 1073741824,
      "status": "ready",
      "tags": [
        "production",
        "ethereum"
      ],
      "updated_at": "2025-01-01T00:00:00Z",
      "url": "https://s3.sva2.nirvanacloud.io/my-bucket"
    }