Help / API

GET /v1/_ping

A trivial smoke endpoint. Returns the auth context derived from your token — useful for confirming a credential works without touching real data.

Headers

Authorization: Bearer <token>

Query parameters

None.

Response

{
  "data": {
    "ok": true,
    "auth_type": "pat",
    "account_id": "01HXXX…",
    "scopes": ["bookings:read", "slots:read"],
    "client_id": "42min_…"
  },
  "meta": { "request_id": "req_…" }
}

• auth_type: "pat" or "oauth".
• account_id: the 42min account (organization) the token is bound to.
• scopes: the expanded scope set carried by the token (aliases unrolled).
• client_id: present only for OAuth tokens.

curl

curl -H "Authorization: Bearer $TOKEN" https://api.42min.us/v1/_ping

Common errors

• 401 invalid_token: token missing, malformed, or unknown.
• 401 token_expired: token has expired (PAT with expiresAt, or access token past its hour).
• 401 token_revoked: token has been revoked.
• 429 rate_limited: bucket exhausted; see Rate limits.