---
title: "Auth Session"
method: GET
path: "/api/auth/session"
tags: ["Auth"]
---

# Auth Session

`GET /api/auth/session`

## Request

- Base URL: `https://mcp.usertold.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.usertold.ai/api/auth/session`
- Auth: none declared

Execute the UserTold auth session operation.

## Response `200`

Success

- object
  - `user` object, nullable, required
    - `id` number, required
    - `email` string, required
    - `name` string, required
    - `google_id` string, nullable, required
    - `github_id` string, nullable, required
    - `connected_auth_providers` string[], required
    - `personal_org_handle` string, nullable, required
    - `last_visited_org_handle` string, nullable, required
    - `personal_org_name` string, nullable, required
    - `terms_accepted_version` string, nullable, required
    - `terms_accepted_at` string, nullable, required
    - `personal_org_reviewed_at` string, nullable, required
    - `needs_onboarding` boolean, required
    - `needs_terms_acceptance` boolean, required
    - `terms_update_available` boolean, required
    - `legal_notices` object[]
      - `id` string, required
      - `publishedAt` string, required
      - `effectiveAt` string, required
      - `summary` string, required
      - `documents` object[], required
        - `document` 'terms' | 'privacy' | 'dpa', required
        - `version` string, required
        - `url` string, uri, required
      - `requiresAffirmativeConsent` boolean, required
    - `needs_org_handle_review` boolean, required
    - `gpc_opt_out_at` string, nullable, required
    - `is_admin` boolean, required
    - `created_at` string, required
    - `updated_at` string, required
    - `account_state` 'provisional' | 'active' | 'reclaimed', required
    - `email_verified_at` string, nullable, required
    - `capabilities` object, required
      - `profile_workspace_edit` boolean, required
      - `draft_research` boolean, required
      - `paid_inference` boolean, required
      - `promotional_credit` boolean, required
      - `study_launch` boolean, required
      - `billing_changes` boolean, required
      - `exports` boolean, required
      - `invitations` boolean, required
      - `integrations` boolean, required
      - `cli_mcp_grants` boolean, required
  - `config` object, required
    - `googleClientId` string, required
    - `githubClientId` string, required
    - `linearClientId` string
    - `environment` string, required
    - `passwordAuthEnabled` boolean, required
    - `passwordRegistrationEnabled` boolean, required
    - `turnstileSiteKey` string, required

## Other responses

- `401`: Not authenticated
- `404`: Not found
- `422`: Domain error (non-retryable)
- `500`: Internal server error
- `503`: Domain error (retryable)

---

[API](https://skmtc.dev/usertold/apis/usertold-ai-api.md) · [All operations](https://skmtc.dev/usertold/apis/usertold-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usertold/apis/usertold-ai-api/revisions/37d5b4f88d38?raw)