Auth

Sign in with Google

Exchanges a Google ID token, issued to this deployment's web client, for a session. The account is the one for the token's address: an address that signed in with an emailed code reaches the same account, and a new address gets one. Google must have verified the address.

post/v1/auth/google

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/auth/google
  • Auth: none required

Request body

id_tokenstring required

The credential Google Identity Services returns to the page.

Example request

{
  "id_token": "eyJhbGciOiJSUzI1NiIs..."
}

Response

Authenticated; a session is returned.

token_type'Bearer' required
access_tokenstring required

Short-lived access JWT. Send as Authorization: Bearer <token>.

expires_ininteger required

Access-token lifetime in seconds.

refresh_tokenstring

Single-use refresh token, rotated on every refresh.

Example response

{
  "token_type": "Bearer",
  "access_token": "eyJhbGciOiJIUzI1NiJ9...",
  "expires_in": 900,
  "refresh_token": "rt_9f2StGXR8Z5jdHi6B...",
  "user": {
    "id": "user_V1StGXR8Z5jdHi6B",
    "email": "ana@acme.com",
    "name": "Ana Silva",
    "email_verified": true,
    "roles": [],
    "usage_alerts": true,
    "created_at": "2026-07-17T00:00:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.