List apps the current account can access

GET

/v1/apps

const url = 'https://api.aetherpush.com/v1/apps';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.aetherpush.com/v1/apps \
  --header 'Authorization: Bearer <token>'

Returns all apps that the authenticated account owns or is a collaborator on, with their deployment names included.

Authorizations

accessKeyAuth
apiKeyAuth
read

Responses

200

List of apps.

application/json

object

apps

required

Array<object>

object

name

required

string

<= 255 characters

collaborators

Map keyed by collaborator email.

object

key

additional properties

object

permission

required

App role. Owner controls the app; Admin manages collaborators and deployments on top of Developer; Developer performs release operations; Viewer is read-only.

string

Allowed values: Owner Admin Developer Viewer

isCurrentAccount

boolean

deployments

List of deployment names registered under this app.

Array<string>

capabilities

Named permissions the requesting account holds on this app.

Array<string>

Allowed values: app.read app.manage app.delete app.transfer collaborators.manage deployments.manage releases.deploy releases.promote releases.rollback metrics.read deploymentKeys.read

Example

{
  "apps": [
    {
      "name": "my-react-native-app",
      "deployments": [
        "Production",
        "Staging"
      ],
      "collaborators": {
        "adrian@aetherpush.com": {
          "permission": "Owner",
          "isCurrentAccount": true
        }
      }
    }
  ]
}

401

Unauthenticated.

application/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"
}