MoveAccount
- Print
- DarkLight
MoveAccount
- Print
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Post
/v1/accounts/{accountId}:move
Availability
Early Access: August 6, 2026
Early Access is gated; contact the Backblaze Sales team for access.
Limited Availability: August 6, 2026
This API is available only to customers with access to the Backblaze Enterprise Web Console. For more information, contact the Backblaze Sales team.
Move an account under a different parent
Changes the account's parent between the organization and an Organizational Unit without modifying any other account properties.
Semantics
- The destination parent MUST exist.
- The caller MUST have permission to remove the account from its current parent and to create accounts under the destination parent.
- The account MUST be in
ACTIVEstate. - Moving an account does not change its
accountId, IAM principals, data-plane configuration, or suspension reasons.
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
Body parameters
{
"destinationParent": "organizationalUnits/ou-prod"
}object
destinationParent
string Required
The new parent resource name. Must be the organization or an Organizational Unit.
ExampleorganizationalUnits/ou-prod
Responses
200
The request succeeded.
{
"name": "accounts/912345678901",
"accountId": "912345678901",
"parent": "organizationalUnits/ou-prod",
"organization": "organizations/org-acme-prod",
"displayName": "tenant-prod",
"billingAccount": "billingAccounts/456",
"state": "ACTIVE",
"suspensionReasons": [],
"etag": "DwZr7A9P0kE=",
"createTime": "2026-02-03T21:10:00Z",
"updateTime": "2026-02-07T11:30:00Z",
"deleteTime": null,
"purgeTime": null
}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
400
The request was malformed or failed validation.
| HTTP Status | Code | Description |
|---|---|---|
| 400 | INVALID_ARGUMENT | One or more request parameters were invalid. |
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.
401
The request was not authenticated.
| HTTP Status | Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Missing, expired, or invalid bearer token. |
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 Status | Code | Description |
|---|---|---|
| 403 | FORBIDDEN | The authenticated principal lacks permission for this action. |
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 Status | Code | Description |
|---|---|---|
| 404 | NOT_FOUND | The resource does not exist or has been purged. |
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 Status | Code | Description |
|---|---|---|
| 409 | CONFLICT | etag mismatch, resource already exists, or precondition failed. |
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 Status | Code | Description |
|---|---|---|
| 429 | TOO_MANY_REQUESTS | Rate limit exceeded. Use exponential backoff. |
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 Status | Code | Description |
|---|---|---|
| 500 | INTERNAL | Unexpected server error. Include the requestId when contacting support. |
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?