Object Storage / Stook | Knowledge Base

Knowledge Base

medianova.com Support Log in

Create a new bucket

POSThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket

Authorization

Path parameters

organization_uuid*string

The unique identifier of the organization

Body

Bucket creation payload

name*string

The name of the bucket

region*string

The region where the bucket will be created

tagsarray of object

Response

Bucket successfully created

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "region": "text",
      "tags": [
        {}
      ]
    }),
});
const data = await response.json();

Response

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

Retrieve information about the bucket

GEThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket

Authorization

Path parameters

organization_uuid*string

The unique identifier of the organization

Response

Bucket details retrieved successfully

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

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

Update an existing bucket

PUThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket

Authorization

Path parameters

organization_uuid*string

The unique identifier of the organization

Body

Bucket update payload

namestring

The name of the bucket

regionstring

The region where the bucket will be updated

tagsarray of object

Response

Bucket successfully updated

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket', {
    method: 'PUT',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "tags": [
        {}
      ]
    }),
});
const data = await response.json();

Response

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

Delete an existing bucket

DELETEhttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket

Authorization

Path parameters

organization_uuid*string

The unique identifier of the organization

Response

Bucket successfully deleted

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

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

Retrieve bucket details

GEThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

bucket_uuid*string

The UUID of the bucket

Response

Bucket details retrieved successfully

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

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

Create a new credential

POSThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials

Authorization

Path parameters

organization_uuid*string

The unique identifier of the organization

Body

Credential creation payload

name*string

The name of the credential

is_readonly*boolean

Indicates if the credential is read-only

buckets*array of string

subfolderstring

The subfolder within the bucket

Response

Credential successfully created

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "is_readonly": true,
      "buckets": [
        null
      ]
    }),
});
const data = await response.json();

Response

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

Retrieve credentials

GEThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials

Authorization

Path parameters

organization_uuid*string

The unique identifier of the organization

Response

Credentials retrieved successfully

Body

statusboolean

Indicates the success of the request

dataarray of object

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "name": "text",
      "is_readonly": true,
      "buckets": [
        "text"
      ],
      "subfolder": "text"
    }
  ]
}

Update an existing credential

PUThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials

Authorization

Path parameters

organization_uuid*string

The unique identifier of the organization

Body

Credential update payload

name*string

The name of the credential

is_readonly*boolean

Indicates if the credential is read-only

buckets*array of string

subfolderstring

The subfolder within the bucket

Response

Credential successfully updated

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials', {
    method: 'PUT',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "is_readonly": true,
      "buckets": [
        null
      ]
    }),
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "name": "text",
    "is_readonly": true,
    "buckets": [
      "text"
    ],
    "subfolder": "text"
  }
}

Delete a credential

DELETEhttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

Response

Credential successfully deleted

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

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

Retrieve credential details

GEThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/credential/{credential_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

credential_uuid*string

The UUID of the credential

Response

Credential details retrieved successfully

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credential/{credential_uuid}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

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

Create a new FTP account

POSThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

Body

FTP account creation payload

name*string

The name of the FTP account

password*string

The password for the FTP account

bucket_uuid*string

The UUID of the associated bucket

is_readonly*boolean

Indicates if the FTP account is read-only

path*string

The path for the FTP account

wrap_rules*array of object

Response

FTP account successfully created

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "password": "text",
      "bucket_uuid": "text",
      "is_readonly": true,
      "path": "text",
      "wrap_rules": [
        {
          "type": "allow",
          "rule": [
            null
          ]
        }
      ]
    }),
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "bucket_uuid": "text",
    "name": "text",
    "path": "text",
    "login_allowed": true,
    "count": 1,
    "is_readonly": true,
    "wrap_rules": [
      {
        "type": "allow",
        "rule": [
          "text"
        ]
      }
    ]
  }
}

Retrieve FTP accounts

GEThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

Response

FTP accounts retrieved successfully

Body

statusboolean

Indicates the success of the request

dataarray of object

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "name": "text",
      "bucket_uuid": "text",
      "path": "text",
      "login_allowed": true,
      "is_readonly": true,
      "wrap_rules": [
        {
          "type": "allow",
          "rule": [
            "text"
          ]
        }
      ]
    }
  ]
}

Delete an FTP account

DELETEhttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

Response

FTP account successfully deleted

Body

statusboolean

Indicates the success of the request

datastring

Message indicating the result of the operation

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true,
  "data": "text"
}

Update FTP account

PUThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

ftp_uuid*string

The UUID of the FTP account

Body

FTP account update payload

name*string

The name of the FTP account

bucket_uuid*string

The UUID of the associated bucket

is_readonly*boolean

Indicates if the FTP account is read-only

path*string

The path for the FTP account

wrap_rules*array of object

password*string

The password for the FTP account

Response

FTP account successfully updated

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp/{ftp_uuid}', {
    method: 'PUT',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "bucket_uuid": "text",
      "is_readonly": true,
      "path": "text",
      "wrap_rules": [
        {
          "type": "allow",
          "rule": [
            null
          ]
        }
      ],
      "password": "text"
    }),
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "bucket_uuid": "text",
    "name": "text",
    "path": "text",
    "login_allowed": true,
    "count": 1,
    "is_readonly": true,
    "wrap_rules": [
      {
        "type": "allow",
        "rule": [
          "text"
        ]
      }
    ]
  }
}

Retrieve FTP account details

GEThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

ftp_uuid*string

The UUID of the FTP account

Response

FTP account details retrieved successfully

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp/{ftp_uuid}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "bucket_uuid": "text",
    "name": "text",
    "path": "text",
    "login_allowed": true,
    "count": 1,
    "is_readonly": true,
    "wrap_rules": [
      {
        "type": "allow",
        "rule": [
          "text"
        ]
      }
    ]
  }
}

Update settings

PUThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

Body

Settings update payload

is_ip_restriction*boolean

Enable or disable IP restriction

restriction_type*enum

Type of IP restriction

allowdeny

ip_list*object

status_cors_header*enum

Status of CORS header

onoff

cors_domains*array of string

List of allowed CORS domains

Response

Settings successfully updated

Body

statusboolean

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings', {
    method: 'PUT',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "is_ip_restriction": true,
      "restriction_type": "allow",
      "ip_list": {
        "allow_ip_list": [
          null
        ],
        "deny_ip_list": [
          null
        ]
      },
      "status_cors_header": "on",
      "cors_domains": [
        null
      ]
    }),
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "name": "text",
    "status": true,
    "is_ip_restriction": true,
    "restriction_type": "text",
    "ip_list": {
      "allow_ip_list": [
        "text"
      ],
      "deny_ip_list": [
        "text"
      ]
    },
    "status_cors_header": "text",
    "cors_domains": [
      "text"
    ]
  }
}

Retrieve settings

GEThttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

Response

Settings retrieved successfully

Body

statusboolean

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "name": "text",
    "status": true,
    "is_ip_restriction": true,
    "restriction_type": "text",
    "ip_list": {
      "allow_ip_list": [
        "text"
      ],
      "deny_ip_list": [
        "text"
      ]
    },
    "status_cors_header": "text",
    "cors_domains": [
      "text"
    ]
  }
}

Delete settings

DELETEhttps://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

Response

Settings deleted successfully

Body

statusboolean

Request

const response = await fetch('https://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true
}

v1/Update Path

PUThttps://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

path_uuid*string

The UUID of the path

Body

Path update payload

label*string

The label of the path

status*boolean

The status of the path

Response

Path successfully updated

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}', {
    method: 'PUT',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "label": "text",
      "status": true
    }),
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "organization_uuid": "text",
    "root_path": "text",
    "size": "text",
    "label": "text",
    "status": true,
    "deleted": true,
    "region": "text",
    "ftp_accounts": [
      {}
    ],
    "stook_accounts": [
      {}
    ]
  }
}

v1/Retrieve Path Details

GEThttps://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

path_uuid*string

The UUID of the path

Response

Path details retrieved successfully

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "organization_uuid": "text",
    "root_path": "text",
    "size": "text",
    "label": "text",
    "status": true,
    "deleted": true,
    "region": "text",
    "ftp_accounts": [
      {}
    ],
    "stook_accounts": [
      {}
    ]
  }
}

v1/Delete Path

DELETEhttps://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

path_uuid*string

The UUID of the path

Response

Path successfully deleted

Body

statusboolean

Indicates the success of the request

Request

const response = await fetch('https://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true
}

v1/Update FTP Account

PUThttps://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

ftp_uuid*string

The UUID of the FTP account

Body

FTP account update payload

is_readonly*boolean

Indicates if the FTP account is read-only

password*string

The password for the FTP account

path*string

The path for the FTP account

wrap_rules*array of object

List of wrap rules for the FTP account

Response

FTP account successfully updated

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}', {
    method: 'PUT',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "is_readonly": true,
      "password": "text",
      "path": "text",
      "wrap_rules": [
        {
          "type": "allow",
          "rule": [
            null
          ]
        }
      ]
    }),
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "path_uuid": "text",
    "name": "text",
    "path": "text",
    "count": 1,
    "is_readonly": true,
    "last_accessed": "text",
    "wrap_rules": [
      {
        "type": "allow",
        "rule": [
          "text"
        ]
      }
    ]
  }
}

v1/Retrieve FTP Account Details

GEThttps://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

ftp_uuid*string

The UUID of the FTP account

Response

FTP account details retrieved successfully

Body

statusboolean

Indicates the success of the request

dataobject

Request

const response = await fetch('https://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true,
  "data": {
    "uuid": "text",
    "path_uuid": "text",
    "name": "text",
    "path": "text",
    "count": 1,
    "is_readonly": true,
    "last_accessed": "text",
    "wrap_rules": [
      {
        "type": "allow",
        "rule": [
          "text"
        ]
      }
    ]
  }
}

v1/Delete FTP Account

DELETEhttps://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorization

Path parameters

organization_uuid*string

The UUID of the organization

ftp_uuid*string

The UUID of the FTP account

Response

FTP account successfully deleted

Body

statusboolean

Indicates the success of the request

Request

const response = await fetch('https://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "status": true
}