Human API

Human API Authentication API

The HAPI Auth Public API for facilitating token exchange with external authentication systems. Exposes POST /v1/admin/token (Admin API client-type token via client_id/client_secret) and POST /v1/connect/token (public Connect token via client_id/client_user_id with optional client_secret, client_user_email, and extra_scopes). Served from https://auth.humanapi.co.

GitHub OpenAPI

Documentation

📖
Documentation
https://reference.humanapi.co/docs/overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/human-api/refs/heads/main/openapi/human-api-auth-admin-token-openapi.json
⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/human-api/refs/heads/main/openapi/human-api-auth-connect-token-openapi.json

OpenAPI Specification

human-api-auth-admin-token-openapi.json Raw ↑ 
{
  "openapi": "3.0.3",
  "info": {
    "description": "Public authentication endpoints for facilitating token exchange with external authentication systems.",
    "version": "1.0.0",
    "title": "HAPI Auth Public",
    "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": "admin",
      "description": "API endpoints to authorize a client app for the Admin API"
    }
  ],
  "paths": {
    "/v1/admin/token": {
      "post": {
        "tags": [
          "admin"
        ],
        "description": "Admin API client type token",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/tokenPayload"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "tokenPayload": {
        "type": "object",
        "required": [
          "client_id",
          "client_secret",
          "type"
        ],
        "properties": {
          "client_id": {
            "type": "string"
          },
          "client_secret": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}