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

statusbooleanOptional

Indicates whether the request was successful.

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",
      "name": "text",
      "selected_actions": [
        "text"
      ],
      "buckets": [
        "text"
      ]
    }
  ]
}

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

statusbooleanOptional

Indicates whether the request was successful.

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",
    "selected_actions": [
      "text"
    ],
    "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.

bucketsstring[]Required

List of bucket UUIDs the credential can access.

subfolderstringOptional

Specific subfolder path restriction, if applicable.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the credential creation was successful.

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: 89

{
  "name": "text",
  "buckets": [
    "text"
  ],
  "selected_actions": [
    "s3:GetObject"
  ],
  "subfolder": "text"
}

200

Successful response

{
  "status": true,
  "data": {
    "uuid": "text",
    "name": "text",
    "selected_actions": [
      "text"
    ],
    "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

namestringOptional

The updated name for the credential.

bucketsstring[]Optional

Updated list of bucket UUIDs the credential can access.

subfolderstringOptional

Updated subfolder path restriction, if applicable.

Responses

200

Successful response

application/json

statusbooleanOptional

Indicates whether the credential update was successful.

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: 89

{
  "name": "text",
  "buckets": [
    "text"
  ],
  "selected_actions": [
    "s3:GetObject"
  ],
  "subfolder": "text"
}

200

Successful response

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

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

statusbooleanOptional

Indicates whether the credential deletion was successful.

messagestringOptional

Confirmation message regarding the deletion process.

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