Blob Update Settings

PUT

account

settings

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/account/settings' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "rules": [
      { "prefix": "invoices", "private": true, "extensions": ["pdf"] },
      { "prefix": "avatars", "max_size": 2097152, "extensions": ["png", "jpg", "webp"], "cache_control": "max-age=86400" },
      { "prefix": "tmp", "delete_after_days": 7 }
    ]
  }'

{
  "status": "success",
  "response": {
    "rules": [
      { "prefix": "invoices/", "private": true, "extensions": ["pdf"], "created_at": "2026-09-25T12:00:00.000Z" },
      { "prefix": "avatars/", "max_size": 2097152, "extensions": ["png", "jpg", "webp"], "cache_control": "max-age=86400", "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

erforderlich

Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.

Update Settings speichert deine Regeln, die jeweils für die Dateien unter einem Präfix gelten. Eine Regel legt Standardwerte und Limits einmalig fest, für jeden Upload darunter, egal ob er von deinem Backend, einem Upload-Token oder dem Dashboard kommt. Erfordert den Scope blob:write und einen kostenpflichtigen Plan. Jeder Plan erlaubt eine bestimmte Anzahl von Regeln: 5 bei Hobby und Standard, 10 bei Pro und 20 bei Enterprise. Vor einem Downgrade gespeicherte Regeln gelten weiter, aber das nächste Speichern muss in den neuen Plan passen. Der Request ersetzt die gesamte Liste: Sende jede Regel, die du behalten willst, und {"rules": []} entfernt alle. Wenn mehrere Regeln auf eine Datei passen, gewinnt die mit dem längsten Präfix.

Standardwerte (private, expire, cache_control) gelten, wenn der Upload keinen eigenen Wert festlegt.
Limits (max_size, extensions) lehnen Uploads außerhalb davon mit FILE_TOO_LARGE oder FILE_TYPE_NOT_ALLOWED ab. Sie gelten für REST-Uploads, nicht für das S3-Gateway.
Automatische Löschung (delete_after_days) löscht Dateien eine bestimmte Anzahl von Tagen, nachdem sie geschrieben wurden. Sie gilt für jede Datei unter dem Präfix, einschließlich bereits vorhandener Dateien und über S3 geschriebener Dateien.

Die automatische Löschung beginnt erst 24 Stunden nach dem Speichern der Regel (active_from in Get Settings), sodass du einen Tag Zeit hast, ein Präfix zu bemerken, das weiter gefasst ist als beabsichtigt. Das erneute Speichern einer unveränderten Regel behält ihr ursprüngliches Datum. Sobald sie aktiv ist, können gelöschte Dateien nicht wiederhergestellt werden.

object[]

erforderlich

Bis zu 5 Regeln bei Hobby und Standard, 10 bei Pro und 20 bei Enterprise.

Anzeigen Eigenschaften

string

erforderlich

Das Präfix, dasselbe Muster wie in Object Post. Wird mit abschließendem / gespeichert, sodass invoices invoices/... abdeckt und nicht invoices-old/....

boolean

Standard-Sichtbarkeit neuer Dateien.

string

Standard-Ablauf neuer Dateien (30d, 6h). Unter 7 Tagen erfordert Enterprise.

number

Maximale Dateigröße in Bytes, von 512 bis 10737418240 (10 GiB).

string[]

Akzeptierte Endungen, 1 bis 50, in Kleinbuchstaben und ohne Punkt (pdf, tar.gz).

string

Standard-Cache: immutable, max-age=N oder no-cache (nur Enterprise).

number

Löscht Dateien so viele Tage, nachdem sie geschrieben wurden, von 1 bis 3650. Unter 7 erfordert Enterprise.

Wechselt der Plan zu einem, der eine Option einer Regel nicht enthält (zum Beispiel ein Ablauf unter 7 Tagen nach dem Verlassen von Enterprise), werden Uploads unter diesem Präfix mit UPGRADE_REQUIRED abgelehnt, bis die Regel geändert wird.

Rate Limits

10 Requests pro Minute (RATE_LIMITED, 429).

Antwort

Gibt die gespeicherten Regeln zurück, in derselben Form wie Get Settings.

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/account/settings' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "rules": [
      { "prefix": "invoices", "private": true, "extensions": ["pdf"] },
      { "prefix": "avatars", "max_size": 2097152, "extensions": ["png", "jpg", "webp"], "cache_control": "max-age=86400" },
      { "prefix": "tmp", "delete_after_days": 7 }
    ]
  }'

{
  "status": "success",
  "response": {
    "rules": [
      { "prefix": "invoices/", "private": true, "extensions": ["pdf"], "created_at": "2026-09-25T12:00:00.000Z" },
      { "prefix": "avatars/", "max_size": 2097152, "extensions": ["png", "jpg", "webp"], "cache_control": "max-age=86400", "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" }
    ]
  }
}

Fehler

Fehler zu einer einzelnen Regel enthalten deren prefix in der Antwort.

Code	HTTP	Wann
`INVALID_BODY`	400	Der Body ist kein JSON-Objekt.
`NOTHING_TO_UPDATE`	400	Der Body hat keine `rules`.
`INVALID_RULES`	400	`rules` ist kein Array von Objekten.
`TOO_MANY_RULES`	400	Mehr als 20 Regeln bei Enterprise.
`INVALID_RULE_PREFIX` / `DUPLICATE_RULE_PREFIX`	400	Ein Präfix ist fehlerhaft oder wiederholt.
`INVALID_RULE_PRIVATE` / `INVALID_RULE_EXPIRE` / `INVALID_RULE_MAX_SIZE` / `INVALID_RULE_EXTENSIONS` / `INVALID_RULE_CACHE_CONTROL` / `INVALID_RULE_DELETE_AFTER`	400	Ein Feld einer Regel ist ungültig.
`PERMISSION_DENIED`	401	Das Konto hat keinen aktiven kostenpflichtigen Plan.
`UPGRADE_REQUIRED`	403	Mehr Regeln, als der Plan erlaubt, oder eine Regel verwendet eine Option, die einen höheren Plan erfordert. Die `message` nennt das Limit oder den Plan.
`RATE_LIMITED`	429	Mehr als 10 Requests in einer Minute.

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/account/settings' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "rules": [
      { "prefix": "invoices", "private": true, "extensions": ["pdf"] },
      { "prefix": "avatars", "max_size": 2097152, "extensions": ["png", "jpg", "webp"], "cache_control": "max-age=86400" },
      { "prefix": "tmp", "delete_after_days": 7 }
    ]
  }'

{
  "status": "success",
  "response": {
    "rules": [
      { "prefix": "invoices/", "private": true, "extensions": ["pdf"], "created_at": "2026-09-25T12:00:00.000Z" },
      { "prefix": "avatars/", "max_size": 2097152, "extensions": ["png", "jpg", "webp"], "cache_control": "max-age=86400", "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" }
    ]
  }
}

Erste Schritte

Objekte

Chunked-Uploads

Konto

Freigabelinks

S3

Rate Limits

Antwort

Fehler

​Rate Limits

​Antwort

​Fehler

Rate Limits

Antwort

Fehler