Blob Get Settings

GET

account

settings

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/account/settings' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "rules": [
      {
        "prefix": "invoices/",
        "private": true,
        "extensions": ["pdf"],
        "created_at": "2026-09-25T12:00:00.000Z"
      },
      {
        "prefix": "tmp/",
        "delete_after_days": 7,
        "created_at": "2026-09-25T12:00:00.000Z",
        "active_from": "2026-09-26T12:00:00.000Z"
      }
    ]
  }
}

string

required

The API key for your account. You can find this in your account settings.

Get Settings returns the rules saved with Update Settings. Each rule applies to the files under its prefix: default visibility, expiry and cache, size and type limits, and automatic deletion. Requires the blob:read scope.

Response

string

“success” if successful, “error” if not.

object

Show Toggle object

array

The rules, as saved. See Update Settings for each field.

Show Toggle object

string

The prefix the rule applies to, ending in /.

boolean

Default visibility.

string

Default expiry.

number

Maximum file size, in bytes.

string[]

Accepted extensions.

string

Default cache.

number

Days after which files are deleted.

ISO 8601

When the rule was saved.

ISO 8601

When automatic deletion starts to act (24 hours after created_at). Present only with delete_after_days.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/account/settings' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "rules": [
      {
        "prefix": "invoices/",
        "private": true,
        "extensions": ["pdf"],
        "created_at": "2026-09-25T12:00:00.000Z"
      },
      {
        "prefix": "tmp/",
        "delete_after_days": 7,
        "created_at": "2026-09-25T12:00:00.000Z",
        "active_from": "2026-09-26T12:00:00.000Z"
      }
    ]
  }
}

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/account/settings' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "rules": [
      {
        "prefix": "invoices/",
        "private": true,
        "extensions": ["pdf"],
        "created_at": "2026-09-25T12:00:00.000Z"
      },
      {
        "prefix": "tmp/",
        "delete_after_days": 7,
        "created_at": "2026-09-25T12:00:00.000Z",
        "active_from": "2026-09-26T12:00:00.000Z"
      }
    ]
  }
}

Getting Started

Objects

Chunked Uploads

Account

Share Links

S3

Response

​Response

Response