Skip to main content
ROUTER can link an Aria Compute (serve) account for cross-product auth and metering. These endpoints read the link state and re-sync key metadata.
Both endpoints are gated to signed-in users (gate_if_users); unauthenticated callers get an unauthorized error.

Get the linked account

Returns the linked serve account public info.

Re-sync the account

Re-pulls the serve-side key list with the stored serve API key (preferred) or the short-lived link token, then updates the local public info. If serve returns 401/403, or the stored key’s prefix is missing from the returned list, the key is marked deleted/revoked, so the dashboard updates and the router stops authenticating with a dead credential. Network or timeout failures leave the prior state untouched.

Response

Both endpoints return ServeAccountPublic:
boolean
Whether a serve user is linked.
string | null
Linked site identifier.
string | null
Serve site URL.
string | null
Serve gateway URL.
object | null
Linked serve user info (id, name, email, etc.).
string | null
Link time (ISO 8601).
string | null
Linked key name.
string | null
Linked key prefix (for display).
boolean
Whether a non-empty key is stored locally.
boolean
Whether the key was deleted/revoked on serve.
string
Link status, e.g. linked, key only, not linked, api key deleted on serve, not linked.

Example