Credentials

Manage API credentials that grant access to your Stook Buckets and subfolders.

List credentials

get

Retrieves a list of access keys and security credentials associated with the specified organization.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

Responses

200

Successful response

application/json

401

Unauthorized access

get

/api/v2/stook/{organization_uuid}/credential

HTTPcURLJavaScriptPython

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

{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "access_key": "text",
      "description": "text",
      "created_at": "2026-01-22T17:54:04.421Z"
    }
  ]
}

Retrieve credential details

get

Retrieves detailed information for a specific access credential, including its permissions and associated buckets.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

credential_uuidstringRequired

Unique identifier for the specific credential.

Responses

200

Successful response

application/json

404

Credential not found

get

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

HTTPcURLJavaScriptPython

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

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

Create an access credential

post

Creates a new access credential with specific permissions for storage buckets or subfolders in the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

Body

application/json

namestringRequired

Name of the credential for identification.

is_readonlybooleanOptional

Indicates whether the credential has read-only permissions.

bucketsstring[]Required

List of bucket UUIDs the credential can access.

subfolderstringOptional

Specific subfolder path restriction, if applicable.

Responses

200

Successful response

application/json

post

/api/v2/stook/{organization_uuid}/credentials

HTTPcURLJavaScriptPython

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

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

200

Successful response

{
  "status": true,
  "data": {
    "uuid": "text",
    "name": "text",
    "is_readonly": true,
    "access_key": "text",
    "secret_key": "text"
  }
}

Update an access credential

put

Updates the configuration and access permissions for an existing credential in the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

credential_uuidstringRequired

Unique identifier for the credential to be updated.

Body

application/json

namestringRequired

The updated name for the credential.

is_readonlybooleanRequired

Sets whether the credential has read-only access.

bucketsstring[]Required

Updated list of bucket UUIDs the credential can access.

subfolderstringOptional

Updated subfolder path restriction, if applicable.

Responses

200

Successful response

application/json

put

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

HTTPcURLJavaScriptPython

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

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

200

Successful response

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

Delete an access credential

delete

Permanently removes a specific access credential from the specified organization in the Medianova Control Panel.

Path parameters

organization_uuidstringRequired

Unique identifier for the organization.

credential_uuidstringRequired

Unique identifier for the credential to be deleted.

Responses

200

Successful response

application/json

404

Credential not found

delete

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

HTTPcURLJavaScriptPython

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

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