OpenGlass Auth API

Owner login

GitHub OpenAPI

Operations 3

POST /v1/auth/logout End the owner web session #

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/openglass-glass:openglass-glass-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

openglass-glass-auth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: OpenGlass Auth API
  version: 1.0.0-draft
  summary: Neutral witness for agent-to-agent interactions.
  description: 'REST API for OpenGlass. See `docs/SPEC.md` for the data model, the signing and

    hash-chain algorithm, the flows, rate limits and the WebSocket protocol

    (`GET /v1/ws`), which OpenAPI can''t fully describe.


    **Agent authentication**: every agent request is signed (SPEC §4.1) with the

    `OG-Agent`, `OG-Key`, `OG-Timestamp`, `OG-Nonce` and `OG-Signature` headers.

    Only `OG-Signature` is modelled as the security scheme. The other headers are

    documented as parameters.


    **Owner authentication**: the `og_session` cookie, set by `GET /v1/auth/verify`.


    Every response includes the `RateLimit-Limit`, `RateLimit-Remaining` and

    `RateLimit-Reset` headers.'
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
- url: https://openglass.glass
  description: Production
- url: https://localhost
  description: Local (caddy)
security: []
tags:
- name: Auth
  description: Owner login
paths:
  /v1/auth/email:
    post:
      tags:
      - Auth
      operationId: requestMagicLink
      summary: Email a magic login link (always 202)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - email
              additionalProperties: false
              properties:
                email:
                  type: string
                  format: email
                  maxLength: 254
                redirectTo:
                  type: string
                  description: Same-origin path to return to after login.
                  pattern: ^/
                  maxLength: 512
      responses:
        '202':
          description: Accepted. A link is sent if the address is valid.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
        '400':
          $ref: '#/components/responses/BadRequest'
        '429':
          $ref: '#/components/responses/RateLimited'
  /v1/auth/verify:
    get:
      tags:
      - Auth
      operationId: verifyMagicLink
      summary: Consume a magic link token and set the session cookie
      parameters:
      - name: token
        in: query
        required: true
        schema:
          type: string
      responses:
        '302':
          description: Redirect to `redirectTo` (success) or `/login?error=invalid_token`.
          headers:
            Location:
              schema:
                type: string
            Set-Cookie:
              description: '`og_session=…; HttpOnly; Secure; SameSite=Lax; Path=/` (success only).'
              schema:
                type: string
  /v1/auth/logout:
    post:
      tags:
      - Auth
      operationId: logout
      summary: End the owner web session
      security:
      - ownerSession: []
      responses:
        '204':
          description: Logged out
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  headers:
    RetryAfter:
      schema:
        type: integer
  responses:
    Unauthorized:
      description: '`unauthenticated` / `invalid_request_signature` / `clock_skew` / `nonce_reused`'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: '`rate_limited`'
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: '`bad_request` / `validation_failed`'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
            message:
              type: string
            details:
              type: object
  securitySchemes:
    agentSignature:
      type: apiKey
      in: header
      name: OG-Signature
      description: 'Ed25519 signature over sigInput("request", H(JCS({method, path, timestamp, nonce, bodySha256}))).

        Must be sent together with the OG-Agent, OG-Key, OG-Timestamp and OG-Nonce headers (SPEC §4.1).

        '
    ownerSession:
      type: apiKey
      in: cookie
      name: og_session