Auth

Sign in with an ID token

POST/auth/token

Authenticates with an ID token issued by a supported external provider.

Parameters

SignInWithIdTokenRequest

provider'apple' | 'azure' | 'discord' | 'github' | 'gitlab' | 'google' | 'snapchat' | 'twitch' | 'twitter' | 'x': The provider that issued the token.
tokenstring: The provider ID token.
access_token?string: Provider access token.
nonce?string: Nonce used when requesting the ID token.
options.captchaToken?string: Captcha verification token.

Returns

userPublicUser
sessionAccessTokenResponse

1import { Jupiter } from '@jupiter-cloud/sdk'2 3const client = new Jupiter(4  'https://api.jupitercloud.co',5  'project-id'6)7 8const result = await client.auth.signInWithIdToken({9  provider: 'google',10  token: providerIdToken,11  nonce12})13 14if (result.error) {15  throw result.error16}17 18console.log(result)

Response

200

1{2  "data": {3    "user": {4      "id": "00000000-0000-4000-8000-000000000000",5      "project_id": "00000000-0000-4000-8000-000000000001",6      "email": "user@example.com",7      "email_verified": true,8      "phone_verified": false,9      "is_anonymous": false,10      "created_at": "2026-01-01T00:00:00.000Z",11      "updated_at": "2026-01-01T00:00:00.000Z"12    },13    "session": {14      "access_token": "eyJhbGciOi...",15      "token_type": "bearer",16      "expires_in": 3600,17      "expires_at": 1767229200,18      "refresh_token": "refresh-token",19      "user": {20        "id": "00000000-0000-4000-8000-000000000000",21        "project_id": "00000000-0000-4000-8000-000000000001",22        "email": "user@example.com",23        "email_verified": true,24        "phone_verified": false,25        "is_anonymous": false,26        "created_at": "2026-01-01T00:00:00.000Z",27        "updated_at": "2026-01-01T00:00:00.000Z"28      }29    }30  },31  "error": null32}