Nerdit Auth API

Reserved /api/auth product boundary.

GitHub OpenAPI

Operations 10

GET /api/auth Auth Boundary #
GET /api/auth/login Login #
GET /api/auth/provider-config Provider Config #
GET /api/auth/social Social Login #
GET /api/auth/social/callback Social Callback #
GET /api/auth/callback Callback #
GET /api/auth/session Current Session #
POST /api/auth/session/organisation Switch Organisation #
POST /api/auth/logout Logout #
POST /api/auth/logout-all Logout All #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nerdit-ai:nerdit-ai-auth-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nerdit-ai-auth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Nerdit Cloud (web) Auth API
  version: 0.1.0
  description: Reserved /api/auth product boundary.
tags:
- name: Auth
  description: Reserved /api/auth product boundary.
paths:
  /api/auth:
    get:
      tags:
      - Auth
      summary: Auth Boundary
      operationId: auth_boundary_api_auth_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '501':
          description: Not Implemented
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
  /api/auth/login:
    get:
      tags:
      - Auth
      summary: Login
      operationId: login_api_auth_login_get
      parameters:
      - name: return_to
        in: query
        required: false
        schema:
          type: string
          default: /
          title: Return To
      - name: identity
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Identity
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Bad Request
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/auth/provider-config:
    get:
      tags:
      - Auth
      summary: Provider Config
      description: 'Serve the authorization page the Supabase values a browser may hold.


        Three, and deliberately not the fourth: the publishable key is

        browser-safe by definition, the project URL and the OAuth client id are

        already public in the authorization redirect every sign-in follows, and

        ``supabase_oauth_client_secret`` is the one value here that would turn

        this unauthenticated GET into a credential leak. Serving the other

        three rather than baking them into the bundle keeps the frontend build

        environment-free, which is how the rest of the SPA already works.'
      operationId: provider_config_api_auth_provider_config_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProviderConfigView'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
  /api/auth/social:
    get:
      tags:
      - Auth
      summary: Social Login
      description: 'Start one named social handshake.


        ``provider_name`` is typed as the two-name literal rather than

        ``str``, so an unknown provider is refused by validation before any

        URL is built — the console offers the providers it publishes a

        button for, not whichever ones the project happens to have on.'
      operationId: social_login_api_auth_social_get
      parameters:
      - name: provider
        in: query
        required: true
        schema:
          enum:
          - github
          - google
          type: string
          title: Provider
      - name: return_to
        in: query
        required: false
        schema:
          type: string
          default: /
          title: Return To
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Bad Request
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/auth/social/callback:
    get:
      tags:
      - Auth
      summary: Social Callback
      description: 'Redeem one social code and mint this console''s own session.


        ``state`` is required, and GoTrue delivers it by preserving the

        query on the ``redirect_to`` it was handed. If a provider release

        ever dropped it instead, every social sign-in would 401 here rather

        than quietly losing its CSRF check — which is the direction this

        whole flow is built to fail in.'
      operationId: social_callback_api_auth_social_callback_get
      parameters:
      - name: code
        in: query
        required: true
        schema:
          type: string
          title: Code
      - name: state
        in: query
        required: true
        schema:
          type: string
          title: State
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Unauthorized
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/auth/callback:
    get:
      tags:
      - Auth
      summary: Callback
      operationId: callback_api_auth_callback_get
      parameters:
      - name: code
        in: query
        required: true
        schema:
          type: string
          title: Code
      - name: state
        in: query
        required: true
        schema:
          type: string
          title: State
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          description: Unauthorized
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/auth/session:
    get:
      tags:
      - Auth
      summary: Current Session
      operationId: current_session_api_auth_session_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionView'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
  /api/auth/session/organisation:
    post:
      tags:
      - Auth
      summary: Switch Organisation
      description: Act in a live organisation, or in person with a null id; anything else 404.
      operationId: switch_organisation_api_auth_session_organisation_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SessionOrganisationRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionView'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/auth/logout:
    post:
      tags:
      - Auth
      summary: Logout
      operationId: logout_api_auth_logout_post
      responses:
        '204':
          description: Successful Response
  /api/auth/logout-all:
    post:
      tags:
      - Auth
      summary: Logout All
      operationId: logout_all_api_auth_logout_all_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LogoutAllView'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
components:
  schemas:
    LogoutAllView:
      properties:
        revoked_sessions:
          type: integer
          title: Revoked Sessions
      additionalProperties: false
      type: object
      required:
      - revoked_sessions
      title: LogoutAllView
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ErrorDetail:
      properties:
        code:
          $ref: '#/components/schemas/ErrorCode'
        message:
          type: string
          title: Message
        status:
          type: integer
          title: Status
        request_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Request Id
        details:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Details
      additionalProperties: false
      type: object
      required:
      - code
      - message
      - status
      title: ErrorDetail
      description: The stable body nested under the envelope's ``error`` key.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ProviderConfigView:
      properties:
        supabase_url:
          type: string
          title: Supabase Url
        supabase_publishable_key:
          type: string
          title: Supabase Publishable Key
        supabase_oauth_client_id:
          type: string
          title: Supabase Oauth Client Id
      additionalProperties: false
      type: object
      required:
      - supabase_url
      - supabase_publishable_key
      - supabase_oauth_client_id
      title: ProviderConfigView
    ErrorCode:
      type: string
      enum:
      - bad_request
      - unauthorized
      - forbidden
      - not_found
      - method_not_allowed
      - conflict
      - validation_failed
      - rate_limited
      - internal_error
      - service_unavailable
      - not_implemented
      - plan_limit_exceeded
      - link_code_invalid
      - link_code_expired
      - link_code_consumed
      - link_code_attempts_exceeded
      - link_code_limit_exceeded
      - link_code_denied
      - link_key_invalid
      - preauth_key_limit_exceeded
      - node_not_found
      - node_already_linked
      - node_offline
      - machine_waking
      - node_revoked
      - entitlement_required
      - organisation_has_members
      - trial_quota_used
      - trial_boxes_busy
      - trial_archived
      - replace.bad_url
      - replace.extractor_unavailable
      - replace.already_claimed
      - csrf_failed
      - auth_transaction_invalid
      - auth_transaction_expired
      - auth_identity_invalid
      - auth_identity_deleting
      - session_invalid
      - session_expired
      - navigation_ticket_invalid
      - navigation_ticket_expired
      - navigation_ticket_consumed
      - proxy_session_invalid
      - proxy_session_expired
      - origin_forbidden
      - hosted_private
      - hosted_disabled
      - visitor_session_required
      - custom_domains.pro_required
      - custom_domains.limit_reached
      - custom_domains.apex_unsupported
      - custom_domains.taken
      - custom_domains.not_found
      - access_revoked
      - webhook_signature_invalid
      - already_subscribed
      - billing_account_missing
      - oauth_invalid_request
      - oauth_invalid_client
      - oauth_invalid_grant
      - oauth_unsupported_grant_type
      - oauth_invalid_scope
      - oauth_access_denied
      - oauth_server_error
      - oauth_temporarily_unavailable
      - oauth_invalid_token
      - oauth_insufficient_scope
      - protocol_version_unsupported
      - node_authentication_failed
      - relay_frame_invalid
      - relay_destination_invalid
      - relay_stream_unknown
      - relay_stream_limit_exceeded
      - relay_body_too_large
      - relay_response_too_large
      - relay_bandwidth_exceeded
      - relay_backpressure
      - relay_draining
      - relay_stream_timeout
      title: ErrorCode
      description: Codes clients may branch on independently of human-readable messages.
    SessionView:
      properties:
        session_id:
          type: string
          title: Session Id
        absolute_expires_at:
          type: string
          title: Absolute Expires At
        csrf_token:
          type: string
          title: Csrf Token
        user:
          $ref: '#/components/schemas/SessionUserView'
        infrastructure:
          type: boolean
          title: Infrastructure
          default: false
        custom_domains:
          type: boolean
          title: Custom Domains
          default: false
        organisation:
          anyOf:
          - $ref: '#/components/schemas/SessionOrganisationView'
          - type: 'null'
        organisations:
          items:
            $ref: '#/components/schemas/SessionMembershipView'
          type: array
          title: Organisations
          default: []
        invitations:
          items:
            $ref: '#/components/schemas/SessionInvitationView'
          type: array
          title: Invitations
          default: []
        can_create_organisation:
          type: boolean
          title: Can Create Organisation
          default: false
      additionalProperties: false
      type: object
      required:
      - session_id
      - absolute_expires_at
      - csrf_token
      - user
      title: SessionView
    SessionInvitationView:
      properties:
        id:
          type: string
          title: Id
        organisation_name:
          type: string
          title: Organisation Name
        role:
          type: string
          title: Role
      additionalProperties: false
      type: object
      required:
      - id
      - organisation_name
      - role
      title: SessionInvitationView
      description: One open invitation addressed to the signed-in account's email.
    SessionMembershipView:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        role:
          type: string
          title: Role
      additionalProperties: false
      type: object
      required:
      - id
      - name
      - role
      title: SessionMembershipView
      description: One organisation the account may switch to, with its role there.
    SessionOrganisationView:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        role:
          type: string
          title: Role
        owner_email:
          type: string
          title: Owner Email
      additionalProperties: false
      type: object
      required:
      - id
      - name
      - role
      - owner_email
      title: SessionOrganisationView
      description: The organisation the session acts in, as re-read on this request.
    SessionOrganisationRequest:
      properties:
        organisation_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Organisation Id
      additionalProperties: false
      type: object
      required:
      - organisation_id
      title: SessionOrganisationRequest
      description: Body of ``POST /api/auth/session/organisation``; null acts in person.
    SessionUserView:
      properties:
        id:
          type: string
          title: Id
        email:
          type: string
          title: Email
        display_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Display Name
        provider_subject:
          type: string
          title: Provider Subject
      additionalProperties: false
      type: object
      required:
      - id
      - email
      - display_name
      - provider_subject
      title: SessionUserView
    ErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      additionalProperties: false
      type: object
      required:
      - error
      title: ErrorEnvelope
      description: Response model used by all cloud API errors.