Skip to main content
PUT
Replace All Folder Rules
Replaces the whole list of folder rules with the list you send. The If-Match header must hold the etag from your last read; if the list changed since, the call fails with BLOB_RULES_CONFLICT and nothing is saved. To change a single rule, use Create or update one rule. Scope: blob:write.
string
required
The etag from the last read of the rule list.
object[]
required
The complete list of rules. Each item takes prefix (required) plus the fields of Create or update one rule. Up to 100 rules, and every rule needs at least one field besides the prefix. expire_seconds can’t be below the plan’s minimum expiration.
string
The workspace ID, when the blob belongs to a workspace. The call acts on the blob of the workspace owner and needs the blob:read workspace permission (blob:manage on routes that change data). Leave it out to act on your own blob.

Example request

Response

object
The saved list and its new etag.

Error Responses

string
The error code indicating the reason for failure. Possible values:
  • AUTH_TOKEN_MISSING (401): No Authorization header was sent.
  • API_KEY_INVALID (401): The API key doesn’t exist, was revoked, or its secret doesn’t match.
  • API_KEY_SCOPE_DENIED (403): The key lacks the scope this route needs (blob:read or blob:write); details.required names it.
  • WORKSPACE_PERMISSION_DENIED (403): Only with workspace_id: you’re not a member, or your role lacks the blob permission.
  • WORKSPACE_NOT_FOUND (404): Only with workspace_id: no workspace with that ID, or you’re not a member.
  • VALIDATION_ERROR (400): A parameter or body field failed validation. details.path names the field; a missing If-Match header returns it with details.path set to if-match.
  • BLOB_NAMESPACE_SUSPENDED (403): The account’s blob storage is suspended, or its plan expired.
  • PLAN_RESTRICTED_FEATURE (403): A rule sets cache_control to no-cache on a plan below Enterprise-26.
  • BLOB_RULES_CONFLICT (409): The If-Match etag is out of date. Read the list again and retry.
  • BLOB_RULE_LIMIT (409): The list has more rules than the plan allows: 5, 10 or 20.