OAuth and Serve Account Linking for Router

Aria Compute ROUTER supports OAuth-based authentication and linking to an Aria Compute Serve account. Use the OAuth start endpoint to redirect users to an identity provider, then handle the callback to establish a session. Linked Serve account information can be viewed and updated through dedicated management endpoints.

Start OAuth Flow

Initiate an OAuth authorization request.

Endpoint

POST /v1/router/auth/oauth/start

Authentication

No authentication required.

Request Body

string

required

Name of the OAuth provider to use.

Response

string

URL to redirect the user to for provider authorization.

string

OAuth state parameter for CSRF protection.

curl -X POST https://router.example.com:8080/v1/router/auth/oauth/start \
  -H "Content-Type: application/json" \
  -d '{"provider":"google"}'

{
  "authorize_url": "https://accounts.google.com/o/oauth2/v2/auth?...",
  "state": "abc123xyz"
}

OAuth Callback

Complete the OAuth flow after the user authorizes with the provider.

Endpoint

GET /v1/router/auth/oauth/callback?code=<code>&state=<state>

Authentication

No authentication required. The callback exchanges the authorization code for a session and sets the session cookie.

Query Parameters

string

required

Authorization code returned by the OAuth provider.

string

required

State value returned by the OAuth provider, used to validate the request.

Response

A successful callback sets the session cookie and returns user summary fields.

curl "https://router.example.com:8080/v1/router/auth/oauth/callback?code=AUTHCODE&state=abc123xyz" \
  -c cookies.txt

Serve Account

View or update the Aria Compute Serve account linked to the current Router user.

Get Linked Account

GET /v1/router/serve/account

Authentication

Send the session cookie or Authorization: Bearer <api-key>.

Response

string

Identifier of the linked Serve account.

string

Email associated with the linked Serve account.

curl https://router.example.com:8080/v1/router/serve/account \
  -H "Authorization: Bearer <api-key>"

Update Linked Account

PUT /v1/router/serve/account

Authentication

Send the session cookie or Authorization: Bearer <api-key>.

Request Body

string

required

New Serve account identifier to link.

curl -X PUT https://router.example.com:8080/v1/router/serve/account \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <api-key>" \
  -d '{"account_id":"serve-acc-456"}'

PIN API

ROUTER API

AGENT API

OAuth and Serve Account Linking for Router

Start OAuth Flow

Endpoint

Authentication

Request Body

Response

OAuth Callback

Endpoint

Authentication

Query Parameters

Response

Serve Account

Get Linked Account

Authentication

Response

Update Linked Account

Authentication

Request Body

​Start OAuth Flow

​Endpoint

​Authentication

​Request Body

​Response

​OAuth Callback

​Endpoint

​Authentication

​Query Parameters

​Response

​Serve Account

​Get Linked Account

​Authentication

​Response

​Update Linked Account

​Authentication

​Request Body

Start OAuth Flow

Endpoint

Authentication

Request Body

Response

OAuth Callback

Endpoint

Authentication

Query Parameters

Response

Serve Account

Get Linked Account

Authentication

Response

Update Linked Account

Authentication

Request Body