{
  "openapi": "3.1.0",
  "info": {
    "title": "Linkality Public Discovery API",
    "version": "0.1.0",
    "description": "Safe public discovery endpoints for Linkality. Private authenticated API routes are intentionally excluded."
  },
  "servers": [
    {
      "url": "https://linkality.com"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "summary": "Health proxy endpoint.",
        "responses": {
          "200": {
            "description": "Health proxy endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Concise Markdown map for LLMs and agents.",
        "responses": {
          "200": {
            "description": "Concise Markdown map for LLMs and agents.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "Full Markdown context pack for LLMs and agents.",
        "responses": {
          "200": {
            "description": "Full Markdown context pack for LLMs and agents.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/auth.md": {
      "get": {
        "summary": "Markdown auth and API key posture. Includes complete ## Agent registration flow with Discovery, Register URI, Identity endpoint, Claim endpoint, Revocation endpoint, Supported identity/credential types/scopes, and Registration steps for manual public beta. No public OAuth/OIDC dynamic registration.",
        "responses": {
          "200": {
            "description": "Markdown auth and API key posture. Includes complete ## Agent registration flow with Discovery, Register URI, Identity endpoint, Claim endpoint, Revocation endpoint, Supported identity/credential types/scopes, and Registration steps for manual public beta. No public OAuth/OIDC dynamic registration.",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "RFC 9727-style linkset API catalog.",
        "responses": {
          "200": {
            "description": "RFC 9727-style linkset API catalog.",
            "content": {
              "application/linkset+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/mcp/server-card.json": {
      "get": {
        "summary": "Linkality MCP server card.",
        "responses": {
          "200": {
            "description": "Linkality MCP server card.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "summary": "Agent Skills discovery index.",
        "responses": {
          "200": {
            "description": "Agent Skills discovery index.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/oauth-protected-resource": {
      "get": {
        "summary": "OAuth Protected Resource Metadata (RFC 9728). Includes resource, non-empty authorization_servers, scopes_supported, bearer_methods_supported. Points to https://linkality.com/auth.md. Clean metadata for manual public beta (no full agent_auth here).",
        "responses": {
          "200": {
            "description": "OAuth Protected Resource Metadata (RFC 9728). Includes resource, non-empty authorization_servers, scopes_supported, bearer_methods_supported. Points to https://linkality.com/auth.md. Clean metadata for manual public beta (no full agent_auth here).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/oauth-authorization-server": {
      "get": {
        "summary": "OAuth Authorization Server metadata (RFC 8414 profile). Includes full agent_auth block (skill, auth_md, registration_mode: manual_public_beta, register_uri, identity_endpoint, claim_endpoint, revocation_endpoint, identity_types_supported, credential_types_supported, grant_types_supported etc). References manual public beta registration at https://linkality.com/contact. No token_endpoint or dynamic client registration.",
        "responses": {
          "200": {
            "description": "OAuth Authorization Server metadata (RFC 8414 profile). Includes full agent_auth block (skill, auth_md, registration_mode: manual_public_beta, register_uri, identity_endpoint, claim_endpoint, revocation_endpoint, identity_types_supported, credential_types_supported, grant_types_supported etc). References manual public beta registration at https://linkality.com/contact. No token_endpoint or dynamic client registration.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/openid-configuration": {
      "get": {
        "summary": "Truthful OIDC limitation metadata. Public OIDC issuer not supported; see https://linkality.com/auth.md and oauth-authorization-server for manual public beta agent_auth.",
        "responses": {
          "200": {
            "description": "Truthful OIDC limitation metadata. Public OIDC issuer not supported; see https://linkality.com/auth.md and oauth-authorization-server for manual public beta agent_auth.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}