Accounts

Manage your Release accounts. Each account contains one or more apps.

Base URL: https://api.release.com

---

List Accounts

Retrieve all accounts accessible to the authenticated user.

Endpoint

GET /accounts

Authentication

Authenticate using headers from your ~/.release.yaml file. To set this up, install the Release CLI and run release auth login.

Header	Description
X-User-Email	User email from ~/.release.yaml (login field)
X-User-Token	User token from ~/.release.yaml (token field)

Headers

Header	Value	Required
Accept	application/json	Yes

Status Codes

Status	Description
200	Successfully retrieved accounts
401	Unauthorized — invalid or missing authentication headers

Example Responses

200 OK

[
  {
    "id": "abc123",
    "name": "My Organization",
    "apps": [
      {
        "id": "def456",
        "name": "my-app"
      }
    ]
  }
]

---

Get Account

Retrieve details for a specific account.

Endpoint

GET /accounts/{accountId}

Authentication

Authenticate using headers from your ~/.release.yaml file. To set this up, install the Release CLI and run release auth login.

Header	Description
X-User-Email	User email from ~/.release.yaml (login field)
X-User-Token	User token from ~/.release.yaml (token field)

Headers

Header	Value	Required
Accept	application/json	Yes

Path Parameters

Parameter	Type	Required	Description
accountId	string (hashid)	Yes	The unique identifier of the account

Status Codes

Status	Description
200	Successfully retrieved account
401	Unauthorized — invalid or missing authentication headers
404	Account not found

Example Responses

200 OK

{
  "id": "abc123",
  "name": "My Organization",
  "apps": [
    {
      "id": "def456",
      "name": "my-app"
    }
  ]
}