Transfer app ownership to another account

POST

/v1/apps/{appName}/transfers

curl --request POST \
  --url https://api.aetherpush.com/v1/apps/example/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "email": "new-owner@example.com" }'

• Production
• Staging
• Local development

Transfers ownership of the app to another registered account. The target account must already exist in Aether. Only the current app.transfer permission (Owner) is required to initiate a transfer.

Authorizations

• accessKeyAuth
• apiKeyAuth
  apps

Parameters

Path Parameters

appName

required

string

Request Body^required

Media typeapplication/json

object

email

required

Email of the account to transfer ownership to.

string format: email

Example

{
  "email": "new-owner@example.com"
}

Responses

201

Ownership transferred successfully.

400

Email missing or invalid.

Media typeapplication/json

object

error

required

Human-readable error message.

string

requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string

Example

{
  "error": "The requested resource was not found.",
  "requestId": "req_abc123"
}

403

Insufficient permissions (app.transfer required).

Media typeapplication/json

object

error

required

Human-readable error message.

string

requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string

Example

{
  "error": "The requested resource was not found.",
  "requestId": "req_abc123"
}

404

App not found, or target account does not exist.

Media typeapplication/json

object

error

required

Human-readable error message.

string

requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string

Example

{
  "error": "The requested resource was not found.",
  "requestId": "req_abc123"
}