Reassign objects owned by one role to another role

Authorization

A service token or OAuth token must have at least one of the following access or scopes in order to use this API endpoint:

Service Token Accesses delete_production_branch_password, delete_production_read_only_branch_password, delete_branch_password

OAuth Scopes

Resource	Scopes
Organization	manage_passwords, manage_production_branch_passwords, manage_read_only_passwords, manage_production_read_only_passwords
Database	manage_passwords, manage_production_branch_passwords, manage_read_only_passwords, manage_production_read_only_passwords
Branch	manage_passwords, manage_read_only_passwords

POST /organizations/{organization}/databases/{database}/branches/{branch}/roles/{id}/reassign

Reassign objects owned by one role to another role

cURL

curl --request POST \
  --url https://api.planetscale.com/v1/organizations/{organization}/databases/{database}/branches/{branch}/roles/{id}/reassign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "successor": "<string>"
}
'

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

organization · string · required

Organization name slug from list_organizations. Example: acme.

database · string · required

Database name slug from list_databases. Example: app-db.

branch · string · required

Branch name from list_branches. Example: main.

id · string · required

The ID of the role

Body

application/json

successor · string · required

The role to reassign ownership to

Response

204

Objects reassigned successfully