Object Storage / Stook

Create a new bucket

post

/v2/stook/{organization_uuid}/bucket

Authorizations

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Body

namestringrequired

The name of the bucket

regionstringrequired

The region where the bucket will be created

tagsobject[]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "region": "text",
    "tags": [
      {
        "key": "text",
        "label": "text"
      }
    ]
  }'

200

200

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

Bucket successfully created

Retrieve information about the bucket

get

/v2/stook/{organization_uuid}/bucket

Authorizations

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket' \
  --header 'Authorization: Bearer JWT'

200

200

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

Bucket details retrieved successfully

Update an existing bucket

put

/v2/stook/{organization_uuid}/bucket

Authorizations

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Body

namestring

The name of the bucket

regionstring

The region where the bucket will be updated

tagsobject[]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "region": "text",
    "tags": [
      {
        "key": "text",
        "label": "text"
      }
    ]
  }'

200

200

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

Bucket successfully updated

Delete an existing bucket

delete

/v2/stook/{organization_uuid}/bucket

Authorizations

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket' \
  --header 'Authorization: Bearer JWT'

200

200

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

Bucket successfully deleted

Retrieve bucket details

get

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

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

bucket_uuidstringrequired

The UUID of the bucket

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}' \
  --header 'Authorization: Bearer JWT'

200

200

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

Bucket details retrieved successfully

Create a new credential

post

/v2/stook/{organization_uuid}/credentials

Authorizations

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Body

namestringrequired

The name of the credential

is_readonlybooleanrequired

Indicates if the credential is read-only

bucketsstring[]required

UUID of the bucket

subfolderstring

The subfolder within the bucket

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "is_readonly": true,
    "buckets": [
      "text"
    ],
    "subfolder": "text"
  }'

200

200

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

Credential successfully created

Retrieve credentials

get

/v2/stook/{organization_uuid}/credentials

Authorizations

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials' \
  --header 'Authorization: Bearer JWT'

200

200

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

Credentials retrieved successfully

Update an existing credential

put

/v2/stook/{organization_uuid}/credentials

Authorizations

Path parameters

organization_uuidstringrequired

The unique identifier of the organization

Body

namestringrequired

The name of the credential

is_readonlybooleanrequired

Indicates if the credential is read-only

bucketsstring[]required

UUID of the bucket

subfolderstring

The subfolder within the bucket

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "is_readonly": true,
    "buckets": [
      "text"
    ],
    "subfolder": "text"
  }'

200

200

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

Credential successfully updated

Delete a credential

delete

/v2/stook/{organization_uuid}/credentials

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credentials' \
  --header 'Authorization: Bearer JWT'

200

200

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

Credential successfully deleted

Retrieve credential details

get

/v2/stook/{organization_uuid}/credential/{credential_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

credential_uuidstringrequired

The UUID of the credential

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/credential/{credential_uuid}' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "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"
          }
        ]
      }
    ]
  }
}

Credential details retrieved successfully

Create a new FTP account

post

/v2/stook/{organization_uuid}/ftp

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

Body

namestringrequired

The name of the FTP account

passwordstringrequired

The password for the FTP account

bucket_uuidstringrequired

The UUID of the associated bucket

is_readonlybooleanrequired

Indicates if the FTP account is read-only

pathstringrequired

The path for the FTP account

wrap_rulesobject[]required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "password": "text",
    "bucket_uuid": "text",
    "is_readonly": true,
    "path": "text",
    "wrap_rules": [
      {
        "type": "allow",
        "rule": [
          "text"
        ]
      }
    ]
  }'

200

200

{
  "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"
        ]
      }
    ]
  }
}

FTP account successfully created

Retrieve FTP accounts

get

/v2/stook/{organization_uuid}/ftp

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp' \
  --header 'Authorization: Bearer JWT'

200

200

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

FTP accounts retrieved successfully

Delete an FTP account

delete

/v2/stook/{organization_uuid}/ftp

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp' \
  --header 'Authorization: Bearer JWT'

200

200

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

FTP account successfully deleted

Update FTP account

put

/v2/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

ftp_uuidstringrequired

The UUID of the FTP account

Body

namestringrequired

The name of the FTP account

bucket_uuidstringrequired

The UUID of the associated bucket

is_readonlybooleanrequired

Indicates if the FTP account is read-only

pathstringrequired

The path for the FTP account

wrap_rulesobject[]required

passwordstringrequired

The password for the FTP account

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp/{ftp_uuid}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "bucket_uuid": "text",
    "is_readonly": true,
    "path": "text",
    "wrap_rules": [
      {
        "type": "allow",
        "rule": [
          "text"
        ]
      }
    ],
    "password": "text"
  }'

200

200

{
  "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"
        ]
      }
    ]
  }
}

FTP account successfully updated

Retrieve FTP account details

get

/v2/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

ftp_uuidstringrequired

The UUID of the FTP account

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/ftp/{ftp_uuid}' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "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"
        ]
      }
    ]
  }
}

FTP account details retrieved successfully

Update settings

put

/v2/stook/{organization_uuid}/settings

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

Body

is_ip_restrictionbooleanrequired

Enable or disable IP restriction

restriction_typestring · enumrequired

Type of IP restriction

Options: allow, deny

ip_listobjectrequired

status_cors_headerstring · enumrequired

Status of CORS header

Options: on, off

cors_domainsstring[]required

List of allowed CORS domains

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "is_ip_restriction": true,
    "restriction_type": "allow",
    "ip_list": {
      "allow_ip_list": [
        "127.0.0.1"
      ],
      "deny_ip_list": [
        "127.0.0.1"
      ]
    },
    "status_cors_header": "on",
    "cors_domains": [
      "text"
    ]
  }'

200

200

{
  "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"
    ]
  }
}

Settings successfully updated

Retrieve settings

get

/v2/stook/{organization_uuid}/settings

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "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"
    ]
  }
}

Settings retrieved successfully

Delete settings

delete

/v2/stook/{organization_uuid}/settings

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://cloud.medianova.com/api/v2/stook/{organization_uuid}/settings' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "status": true
}

Settings deleted successfully

v1/Update Path

put

/stook/{organization_uuid}/path/{path_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

path_uuidstringrequired

The UUID of the path

Body

labelstringrequired

The label of the path

statusbooleanrequired

The status of the path

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "label": "text",
    "status": true
  }'

200

200

{
  "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": [
      {}
    ]
  }
}

Path successfully updated

v1/Retrieve Path Details

get

/stook/{organization_uuid}/path/{path_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

path_uuidstringrequired

The UUID of the path

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "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": [
      {}
    ]
  }
}

Path details retrieved successfully

v1/Delete Path

delete

/stook/{organization_uuid}/path/{path_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

path_uuidstringrequired

The UUID of the path

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://cloud.medianova.com/api/stook/{organization_uuid}/path/{path_uuid}' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "status": true
}

Path successfully deleted

v1/Update FTP Account

put

/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

ftp_uuidstringrequired

The UUID of the FTP account

Body

is_readonlybooleanrequired

Indicates if the FTP account is read-only

passwordstringrequired

The password for the FTP account

pathstringrequired

The path for the FTP account

wrap_rulesobject[]required

List of wrap rules for the FTP account

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "is_readonly": true,
    "password": "text",
    "path": "text",
    "wrap_rules": [
      {
        "type": "allow",
        "rule": [
          "text"
        ]
      }
    ]
  }'

200

200

{
  "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"
        ]
      }
    ]
  }
}

FTP account successfully updated

v1/Retrieve FTP Account Details

get

/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

ftp_uuidstringrequired

The UUID of the FTP account

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "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"
        ]
      }
    ]
  }
}

FTP account details retrieved successfully

v1/Delete FTP Account

delete

/stook/{organization_uuid}/ftp/{ftp_uuid}

Authorizations

Path parameters

organization_uuidstringrequired

The UUID of the organization

ftp_uuidstringrequired

The UUID of the FTP account

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://cloud.medianova.com/api/stook/{organization_uuid}/ftp/{ftp_uuid}' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "status": true
}

FTP account successfully deleted