Check whether the current bearer token is valid

GET

/v1/authenticated

const url = 'https://api.aetherpush.com/v1/authenticated';
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/authenticated \
  --header 'Authorization: Bearer <token>'

Lightweight session-validation endpoint. Returns 200 with { authenticated: true } if the bearer token is valid and not expired; 401 otherwise. Useful for the dashboard to verify on boot whether the cached session is still alive.

Rate limited to 100 requests per 15 minutes.

Authorizations

accessKeyAuth
apiKeyAuth

Responses

200

Token is valid.

application/json

object

authenticated

required

boolean

Example

{
  "authenticated": true
}

401

Token is missing, invalid, or expired.

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 session or access key being used is invalid, please run \"aether login\" again.",
  "requestId": "req_abc123"
}