openapi: 3.2.0
info:
  description: Public authentication endpoints for facilitating token exchange with external authentication systems.
  version: 1.0.0
  title: HAPI Auth Public Connect API
  termsOfService: https://www.humanapi.co/developer-terms
  contact:
    email: help@humanapi.co
    url: https://www.humanapi.co/contact
servers:
- url: https://auth.humanapi.co
  description: Production server
tags:
- name: connect
  description: API endpoints to generate tokens for Connect App
paths:
  /v1/connect/token:
    post:
      tags:
      - connect
      description: Public method for connect to generate tokens
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/connectTokenPayload'
      responses:
        '200':
          description: OK
components:
  schemas:
    connectTokenPayload:
      type: object
      required:
      - client_id
      - client_user_id
      - type
      properties:
        client_id:
          type: string
        client_user_id:
          type: string
        client_secret:
          type: string
        client_user_email:
          type: string
        type:
          type: string
        extra_scopes:
          type: array
          items:
            type: string
x-readme:
  explorer-enabled: true
  proxy-enabled: true