Credentials

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

Retrieve credentials

get

Authorizations

Bearer

Path parameters

organization_uuidstringRequired

The unique identifier of the organization

Responses

200

Credentials retrieved successfully

application/json

get

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

HTTPcURLJavaScriptPython

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

200

Credentials retrieved successfully

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

Retrieve credential details

get

Authorizations

Bearer

Path parameters

organization_uuidstringRequired

The UUID of the organization

credential_uuidstringRequired

The UUID of the credential

Responses

200

Credential details retrieved successfully

application/json

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

200

Credential details retrieved successfully

{
  "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 credential

post

Authorizations

Bearer

Path parameters

organization_uuidstringRequired

The unique identifier of the organization

Body

application/json

namestringRequired

The name of the credential

is_readonlybooleanOptional

Indicates if the credential is read-only

bucketsstring[]Required

UUID of the bucket

subfolderstringOptional

The subfolder within the bucket

Responses

200

Credential successfully created

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

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

200

Credential successfully created

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

Update an existing credential

put

Authorizations

Bearer

Path parameters

organization_uuidstringRequired

The unique identifier of the organization

credential_uuidstringRequired

The unique identifier of the credential

Body

application/json

namestringRequired

The name of the credential

is_readonlybooleanRequired

Indicates if the credential is read-only

bucketsstring[]Required

UUID of the bucket

subfolderstringOptional

The subfolder within the bucket

Responses

200

Credential successfully updated

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

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

200

Credential successfully updated

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

Delete a credential

delete

Authorizations

Bearer

Path parameters

organization_uuidstringRequired

The UUID of the organization

credential_uuidstringRequired

The UUID of the credential

Responses

200

Credential successfully deleted

application/json

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

200

Credential successfully deleted

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