Contents x
DeleteAccount
  • 17 Sep 2026
  • Print
  • Dark
    Light
Contents

DeleteAccount

  • Updated on 17 Sep 2026
  • Print
  • Dark
    Light
Article summary

Delete
/v1/accounts/{accountId}

Availability

Early Access: August 1, 2026

Early Access is gated; contact the Backblaze Sales team for access.

Limited Availability: August 1, 2026

This API is available only to customers with access to the Backblaze Enterprise Web Console. For more information, contact the Backblaze Sales team.

Request deletion of an account

Requests deletion and starts a retention window. If the account is ACTIVE or SUSPENDED, the service sets state to DELETED, sets deleteTime, and sets purgeTime from the requested retention duration.

Semantics

  • The account may be in ACTIVE, DELETED, or SUSPENDED state, but deletion is not allowed while BACKBLAZE_INITIATED is present in suspensionReasons.
  • An existing EXTERNALLY_INITIATED suspension reason is retained.
  • If the account is already DELETED, the request is a no-op success and does not change deleteTime or purgeTime.
  • The account can be restored before purgeTime by calling UndeleteAccount.

If ttl is omitted, the server uses 2592000s (30 days). If supplied, ttl must use protobuf Duration JSON format and be between 86400s (1 day) and 2592000s (30 days), inclusive.

Security
HTTP
Type bearer

Short-lived bearer token obtained from GET /orgs/v1/authorize. Sent as Authorization - Bearer .

Path parameters
accountId
stringRequired

The numeric identifier of the account. Valid account IDs match 9[0-4][0-9]{10}.

Pattern^9[0-4][0-9]{10}$
Example912345678901
Query parameters
ttl
string

Retention duration before purge, in protobuf Duration JSON format. Default 2592000s (30 days); minimum 86400s (1 day); maximum 2592000s (30 days).

Default"2592000s"
Pattern^-?(?:0|[1-9][0-9]{0,11})(?:\.[0-9]{1,9})?s$
Example2592000s
Responses
200

The request succeeded.

{
  "name": "accounts/912345678901",
  "accountId": "912345678901",
  "parent": "organizations/org-acme-prod",
  "organization": "organizations/org-acme-prod",
  "displayName": "tenant-prod-renamed",
  "billingAccount": "billingAccounts/456",
  "state": "DELETED",
  "suspensionReasons": [],
  "etag": "DwZr7A9P0kE=",
  "createTime": "2026-02-03T21:10:00Z",
  "updateTime": "2026-02-05T10:00:00Z",
  "deleteTime": "2026-02-05T10:00:00Z",
  "purgeTime": "2026-03-07T10:00:00Z"
}
object
name
string

Resource name in the form accounts/.

Exampleaccounts/912345678901
accountId
string

The numeric account identifier. Valid values match 9[0-4][0-9]{10}.

Example912345678901
parent
string

Parent resource name. May be an organization or an Organizational Unit.

Exampleorganizations/org-acme-prod
organization
string

The organization the account belongs to. Always populated, even if parent is an Organizational Unit.

Exampleorganizations/org-acme-prod
billingAccount
string

Billing account reference, in the form billingAccounts/. Must belong to the same organization as the account. Cannot be changed after creation.

ExamplebillingAccounts/456
displayName
string
Exampletenant-prod
state
string

Account lifecycle state. An account is SUSPENDED while one or more suspension reasons are active.

Valid values[ "ACTIVE", "SUSPENDED", "DELETED" ]
ExampleACTIVE
suspensionReasons
Array of string

Reasons the account is suspended. Values are unique and array order is unspecified.

Example[]
string
Valid values[ "BACKBLAZE_INITIATED", "EXTERNALLY_INITIATED" ]
etag
string
ExampleBwXk9a2J8p0=
createTime
string (date-time)
updateTime
string (date-time)
deleteTime
string (date-time) | null
purgeTime
string (date-time) | null
401

The request was not authenticated.

HTTP StatusCodeDescription
401UNAUTHORIZEDMissing, expired, or invalid bearer token.
Expand All
object
requestId
string

Opaque correlation identifier matching the Request-Id response header. Include in support requests.

Example4bf92f3577b34da6a3ce929d0e0e4736
error
object
code
integer

Numeric error code.

Example10
message
string

Human-readable description of the error.

Exampleetag mismatch
details
object

Reserved for structured, non-sensitive diagnostic information related to the error condition.

403

The caller is not authorized to perform this operation.

HTTP StatusCodeDescription
403FORBIDDENThe authenticated principal lacks permission for this action.
Expand All
object
requestId
string

Opaque correlation identifier matching the Request-Id response header. Include in support requests.

Example4bf92f3577b34da6a3ce929d0e0e4736
error
object
code
integer

Numeric error code.

Example10
message
string

Human-readable description of the error.

Exampleetag mismatch
details
object

Reserved for structured, non-sensitive diagnostic information related to the error condition.

404

The requested resource was not found.

HTTP StatusCodeDescription
404NOT_FOUNDThe resource does not exist or has been purged.
Expand All
object
requestId
string

Opaque correlation identifier matching the Request-Id response header. Include in support requests.

Example4bf92f3577b34da6a3ce929d0e0e4736
error
object
code
integer

Numeric error code.

Example10
message
string

Human-readable description of the error.

Exampleetag mismatch
details
object

Reserved for structured, non-sensitive diagnostic information related to the error condition.

409

The request conflicted with the current state of the resource.

HTTP StatusCodeDescription
409CONFLICTetag mismatch, resource already exists, or precondition failed.
Expand All
object
requestId
string

Opaque correlation identifier matching the Request-Id response header. Include in support requests.

Example4bf92f3577b34da6a3ce929d0e0e4736
error
object
code
integer

Numeric error code.

Example10
message
string

Human-readable description of the error.

Exampleetag mismatch
details
object

Reserved for structured, non-sensitive diagnostic information related to the error condition.

429

The request was rate-limited.

HTTP StatusCodeDescription
429TOO_MANY_REQUESTSRate limit exceeded. Use exponential backoff.
Expand All
object
requestId
string

Opaque correlation identifier matching the Request-Id response header. Include in support requests.

Example4bf92f3577b34da6a3ce929d0e0e4736
error
object
code
integer

Numeric error code.

Example10
message
string

Human-readable description of the error.

Exampleetag mismatch
details
object

Reserved for structured, non-sensitive diagnostic information related to the error condition.

500

The server encountered an unexpected condition.

HTTP StatusCodeDescription
500INTERNALUnexpected server error. Include the requestId when contacting support.
Expand All
object
requestId
string

Opaque correlation identifier matching the Request-Id response header. Include in support requests.

Example4bf92f3577b34da6a3ce929d0e0e4736
error
object
code
integer

Numeric error code.

Example10
message
string

Human-readable description of the error.

Exampleetag mismatch
details
object

Reserved for structured, non-sensitive diagnostic information related to the error condition.

Was this article helpful?
What's Next