Buckets

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

Retrieve information about the bucket

get

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

The unique identifier of the organization

Responses

200

Bucket details retrieved successfully

application/json

get

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

HTTPcURLJavaScriptPython

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

200

Bucket details retrieved successfully

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

Retrieve bucket details

get

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

The UUID of the organization

bucket_uuidstringRequired

The UUID of the bucket

Responses

200

Bucket details retrieved successfully

application/json

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
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Bucket details retrieved successfully

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

Create a new bucket

post

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

The unique identifier of the organization

Body

application/json

namestringRequired

The name of the bucket

regionstring · enumOptional

The region where the bucket will be created

Possible values:

Responses

200

Bucket successfully created

application/json

post

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

HTTPcURLJavaScriptPython

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

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

200

Bucket successfully created

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

Update an existing bucket

put

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

The unique identifier of the organization

bucket_uuidstringRequired

The unique identifier of the bucket

Body

application/json

Responses

200

Bucket successfully updated

application/json

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
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 40

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

200

Bucket successfully updated

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

Delete an existing bucket

delete

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_uuidstringRequired

The unique identifier of the organization

bucket_uuidstringRequired

The unique identifier of the bucket

Responses

200

Bucket successfully deleted

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
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Bucket successfully deleted

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