Buckets

Manage your Stook Buckets — create, list, update, and delete them.

List all buckets

get

Retrieves comprehensive information about all buckets associated with the specified organization.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the request was successful.

get

/api/v2/stook/{organization_uuid}/bucket

HTTPcURLJavaScriptPython

GET /api/api/v2/stook/{organization_uuid}/bucket HTTP/1.1
Host: cloud.medianova.com
Accept: */*

200

Successful response

{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "name": "text",
      "region": "text",
      "size": "text"
    }
  ]
}

Retrieve bucket details

get

Retrieves detailed configuration and status information for a specific storage bucket.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

bucket_uuidstringRequired

Unique identifier for the storage bucket.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the request was successful.

get

/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}

HTTPcURLJavaScriptPython

GET /api/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid} HTTP/1.1
Host: cloud.medianova.com
Accept: */*

200

Successful response

{
  "status": true,
  "data": {
    "uuid": "text",
    "organization_uuid": "text",
    "name": "text",
    "region": "text",
    "size": "text",
    "tags": [
      {
        "key": "text",
        "label": "text"
      }
    ]
  }
}

Create a new bucket

post

Creates a new storage bucket for the specified organization in the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

Body

application/json

namestringRequired

The unique name for the storage bucket.

regionstring · enumOptional

Geographic region for bucket hosting.

Possible values:

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the bucket creation was successful.

post

/api/v2/stook/{organization_uuid}/bucket

HTTPcURLJavaScriptPython

POST /api/api/v2/stook/{organization_uuid}/bucket HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "name": "text",
  "region": "eu-ist-1",
  "tags": [
    {
      "key": "text",
      "label": "text"
    }
  ]
}

200

Successful response

{
  "status": true,
  "data": {
    "uuid": "text",
    "organization_uuid": "text",
    "name": "text",
    "region": "text",
    "size": "text"
  }
}

Update a bucket

put

Updates the configuration, such as tags, for an existing storage bucket in the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

bucket_uuidstringRequired

Unique identifier for the storage bucket.

Body

application/json

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the bucket update was successful.

put

/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}

HTTPcURLJavaScriptPython

PUT /api/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid} HTTP/1.1
Host: cloud.medianova.com
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "tags": [
    {
      "key": "text",
      "label": "text"
    }
  ]
}

200

Successful response

{
  "status": true,
  "data": {
    "uuid": "text",
    "organization_uuid": "text",
    "name": "text",
    "region": "text",
    "size": "text"
  }
}

Delete a bucket

delete

Permanently removes the specified storage bucket and all its contents from the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

bucket_uuidstringRequired

Unique identifier for the storage bucket to be deleted.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the bucket deletion was successful.

422

Validation error

application/json

delete

/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}

HTTPcURLJavaScriptPython

DELETE /api/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid} HTTP/1.1
Host: cloud.medianova.com
Accept: */*

{
  "status": true,
  "data": {
    "uuid": "text",
    "organization_uuid": "text",
    "name": "text"
  }
}