Initiate OAuth authorization (PKCE)

curl --request GET \
  --url https://api.aireserve.com/v1/authorize

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

AWS CLI login

Initiate OAuth authorization (PKCE)

Called by aws login --profile … (AWS CLI v2.32.0+) to start the OAuth authorization code + PKCE flow. A valid request returns HTTP 302, redirecting the browser to the AI Reserve portal approval page. After the user approves, the portal redirects the authorization code and state to redirect_uri: for same-device flows, redirect_uri is a http://127.0.0.1:<port>/oauth/callback the CLI listens on locally; for cross-device flows (--remote), redirect_uri is https://api.aireserve.com/v1/sessions/confirmation, which then 302s to the portal confirmation page where the user copies a Base64 string back into the CLI. No API key is required — the caller has not authenticated yet.

GET

/

v1

/

authorize

Initiate OAuth authorization (PKCE)

curl --request GET \
  --url https://api.aireserve.com/v1/authorize

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Query Parameters

response_type

enum<string>

required

Must be code (authorization code flow).

Available options:

code

client_id

string

required

AWS CLI client identifier (same-device or cross-device ARN). Matched against the registered client list for the signin endpoint.

redirect_uri

string<uri>

required

Callback URI. Same-device: http://127.0.0.1:<port>/oauth/callback. Cross-device: https://api.aireserve.com/v1/sessions/confirmation.

code_challenge

string

required

PKCE code challenge: BASE64URL(SHA-256(code_verifier)).

code_challenge_method

enum<string>

required

Must be SHA-256.

Available options:

SHA-256

scope

enum<string>

required

Must be openid.

Available options:

openid

state

string

required

Opaque CSRF token generated by the CLI. Passed through unchanged to redirect_uri.

Response

Redirect to the AI Reserve portal approval page. After the user approves, the portal redirects code and state to redirect_uri.