> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glassmarkets.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Start an invited account authenticator setup

> Creates an authenticator setup for the inactive account attached to a valid invitation. Requires a trusted frontend origin.



## OpenAPI

````yaml /openapi.yaml post /v1/onboarding/authenticator/
openapi: 3.0.3
info:
  title: Glass Market API
  version: 1.0.0
  x-logo:
    url: https://api.glassmarkets.io/static/black.png
    backgroundColor: '#FFFFFF'
    altText: Glass Market API
  description: >

    Guides, a quickstart and code samples are at

    [docs.glassmarkets.io](https://docs.glassmarkets.io). The API serves the
    data

    behind the GlassMarkets app: market data collected from crypto exchanges,
    and

    market-making data for the assets your organizations work on. The

    [Authentication guide](https://docs.glassmarkets.io/guides/authentication)

    covers login: `POST /v1/login/` returns a token that goes on every request
    as

    `Authorization: Token <token>`.
servers:
  - url: https://api.glassmarkets.io
security: []
tags:
  - name: Authentication
    description: Log in, log out and read the current session.
  - name: Organizations
    description: Your organizations, and the assets, exchanges and pairs each one covers.
  - name: Reported metrics
    description: Volume, depth and spread that market makers report for their assets.
  - name: Trusted metrics
    description: >-
      Volume, depth and spread that Shield measures directly from market makers'
      exchange accounts.
  - name: Market maker metrics
    description: >-
      Market-maker volume, depth, spread, uptime and coverage, combining trusted
      and reported data.
  - name: Targets
    description: >-
      Market-making targets per asset, exchange and pair, and whether they are
      met.
  - name: Market data
    description: >-
      Exchange market data for your assets: volume, spread, order book depth,
      slippage, uptime, futures and more.
  - name: Leaderboard
    description: Trading pairs across exchanges, ranked by market data.
  - name: Loans
    description: Token loans to market makers for your assets.
  - name: RFQ
    description: >-
      Requests for quotes: a project invites market makers to propose
      market-making terms for its token.
  - name: Account
    description: Manage your password, passkeys and two-factor authentication.
externalDocs:
  url: https://docs.glassmarkets.io
  description: Guides, quickstart and code samples
paths:
  /v1/onboarding/authenticator/:
    post:
      tags:
        - Authentication
      summary: Start an invited account authenticator setup
      description: >-
        Creates an authenticator setup for the inactive account attached to a
        valid invitation. Requires a trusted frontend origin.
      operationId: v1_onboarding_authenticator_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InviteToken'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/InviteToken'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/InviteToken'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TotpSetupOptions'
          description: ''
        '400':
          description: A field is missing or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationErrors'
              examples:
                InvalidInput:
                  value:
                    token:
                      - This field is required.
        '429':
          $ref: '#/components/responses/Throttled'
components:
  schemas:
    InviteToken:
      type: object
      properties:
        token:
          type: string
          writeOnly: true
          maxLength: 512
      required:
        - token
    TotpSetupOptions:
      type: object
      properties:
        setup_id:
          type: string
        secret:
          type: string
        provisioning_uri:
          type: string
      required:
        - provisioning_uri
        - secret
        - setup_id
    ValidationErrors:
      type: object
      description: >-
        One entry per invalid field; `non_field_errors` covers the request as a
        whole. A field carries a list of messages or a single message; a nested
        field carries an object, or a list of objects, of the same shape.
      additionalProperties:
        anyOf:
          - type: array
            items:
              type: string
          - type: string
          - type: object
          - type: array
            items:
              type: object
    ErrorDetail:
      type: object
      properties:
        detail:
          type: string
      required:
        - detail
  responses:
    Throttled:
      description: Too many attempts. Wait the time given in `detail`, then retry.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorDetail'
          examples:
            Throttled:
              value:
                detail: Request was throttled. Expected available in 42 seconds.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.