{
  "specVersion": "1.0",
  "host": {
    "displayName": "AlbaMed",
    "documentationUrl": "https://albamed.org/docs/api",
    "logoUrl": "https://albamed.org/assets/logo.png"
  },
  "entries": [
    {
      "identifier": "urn:air:albamed.org:api:openapi",
      "displayName": "AlbaMed public API description",
      "type": "application/vnd.oai.openapi+json;version=3.1.0",
      "url": "https://albamed.org/api/openapi.json",
      "description": "OpenAPI 3.1 description of every public endpoint. `security: []` at the document root: no credentials are required.",
      "representativeQueries": [
        "what endpoints does albamed.org expose",
        "how do I call the AlbaMed API",
        "does the AlbaMed API need an API key"
      ],
      "tags": [
        "api",
        "openapi",
        "healthcare"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:api:catalog",
      "displayName": "AlbaMed API catalog",
      "type": "application/linkset+json",
      "url": "https://albamed.org/.well-known/api-catalog",
      "description": "RFC 9727 linkset: one entry per public API, each linking to its description, documentation and governing terms.",
      "representativeQueries": [
        "list the APIs published by albamed.org",
        "where is AlbaMed's API catalog"
      ],
      "tags": [
        "api",
        "catalog",
        "rfc9727"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:api:legal-privacy",
      "displayName": "AlbaMed Privacy Policy (JSON)",
      "type": "application/json",
      "url": "https://albamed.org/api/legal/privacy",
      "description": "The published Privacy Policy as structured JSON: version, effective date and every section with its binding text and a plain-language summary. English or Spanish.",
      "representativeQueries": [
        "what does AlbaMed do with patient data",
        "where does AlbaMed host its data",
        "how do I request a BAA from AlbaMed",
        "what is AlbaMed's privacy policy"
      ],
      "tags": [
        "legal",
        "privacy",
        "hipaa"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:api:legal-terms",
      "displayName": "AlbaMed Terms of Service (JSON)",
      "type": "application/json",
      "url": "https://albamed.org/api/legal/terms",
      "description": "The published Terms of Service as structured JSON, section by section, in English or Spanish.",
      "representativeQueries": [
        "what are AlbaMed's terms of service",
        "what rules govern the use of albamed.org"
      ],
      "tags": [
        "legal",
        "terms"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:api:branding",
      "displayName": "AlbaMed brand feed",
      "type": "application/json",
      "url": "https://albamed.org/api/branding",
      "description": "Brand values shared across the AlbaMed systems: site name, logo, social preview image and marketing copy.",
      "representativeQueries": [
        "what is AlbaMed's logo url",
        "what is AlbaMed's social preview image"
      ],
      "tags": [
        "branding",
        "assets"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:doc:api-documentation",
      "displayName": "AlbaMed API documentation",
      "type": "text/html",
      "url": "https://albamed.org/docs/api",
      "description": "Human documentation of the public API, the discovery headers and the markdown representation of every page.",
      "representativeQueries": [
        "how do agents read albamed.org",
        "does AlbaMed support markdown for agents",
        "how is the AlbaMed API documented"
      ],
      "tags": [
        "documentation",
        "api"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:auth:auth-md",
      "displayName": "How to authenticate with AlbaMed",
      "type": "text/markdown",
      "url": "https://albamed.org/auth.md",
      "description": "The auth.md recipe. AlbaMed's answer is the anonymous branch: no registration, no credentials, no tokens, and why no OAuth metadata is published.",
      "representativeQueries": [
        "how do I authenticate with the AlbaMed API",
        "does AlbaMed issue API keys",
        "does albamed.org have an OAuth server"
      ],
      "tags": [
        "auth",
        "anonymous"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:skill:index",
      "displayName": "AlbaMed agent skills index",
      "type": "application/json",
      "url": "https://albamed.org/.well-known/agent-skills/index.json",
      "description": "Agent Skills Discovery index of the procedures an agent can run against this site.",
      "representativeQueries": [
        "what can an agent do with albamed.org",
        "list AlbaMed's agent skills"
      ],
      "tags": [
        "skills",
        "discovery"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:agent:index",
      "displayName": "AlbaMed agent index",
      "type": "application/json",
      "url": "https://albamed.org/.well-known/agents.json",
      "description": "Organizational agent index. `agents` is empty: AlbaMed publishes no A2A endpoint and no MCP server, and the index says where to go instead.",
      "representativeQueries": [
        "does AlbaMed have an MCP server",
        "does AlbaMed expose an A2A agent",
        "what agent endpoints does albamed.org publish"
      ],
      "tags": [
        "agents",
        "discovery"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:site:jsonld",
      "displayName": "AlbaMed organization graph",
      "type": "application/ld+json",
      "url": "https://albamed.org/site.jsonld",
      "description": "schema.org graph: the organization, the services it provides, where it operates and its FAQ.",
      "representativeQueries": [
        "what services does AlbaMed offer",
        "where does AlbaMed operate",
        "how do I contact AlbaMed"
      ],
      "tags": [
        "organization",
        "schema.org"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:skill:api-discovery",
      "displayName": "albamed-api-discovery",
      "type": "text/markdown",
      "url": "https://albamed.org/.well-known/agent-skills/albamed-api-discovery/SKILL.md",
      "description": "Find and use every public AlbaMed API from one request: Link headers, the RFC 9727 catalog, the OpenAPI description, and pages as markdown.",
      "representativeQueries": [
        "how do I discover the AlbaMed API",
        "read an albamed.org page as markdown",
        "what does albamed.org publish for agents"
      ],
      "tags": [
        "agent-skill",
        "skill-md",
        "albamed"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:skill:legal-documents",
      "displayName": "albamed-legal-documents",
      "type": "text/markdown",
      "url": "https://albamed.org/.well-known/agent-skills/albamed-legal-documents/SKILL.md",
      "description": "Read AlbaMed's published Privacy Policy or Terms of Service as structured JSON — versions, effective dates, sections and plain-language summaries, EN or ES.",
      "representativeQueries": [
        "fetch AlbaMed's privacy policy as JSON",
        "has AlbaMed published a new version of its terms",
        "summarize a section of AlbaMed's privacy policy"
      ],
      "tags": [
        "agent-skill",
        "skill-md",
        "albamed"
      ],
      "version": "1.5.0"
    },
    {
      "identifier": "urn:air:albamed.org:skill:contact",
      "displayName": "albamed-contact",
      "type": "text/markdown",
      "url": "https://albamed.org/.well-known/agent-skills/albamed-contact/SKILL.md",
      "description": "Submit the AlbaMed contact form correctly, including the CSRF token exchange and the validation error shape.",
      "representativeQueries": [
        "send AlbaMed a message",
        "request a quote from AlbaMed",
        "how do I submit the AlbaMed contact form"
      ],
      "tags": [
        "agent-skill",
        "skill-md",
        "albamed"
      ],
      "version": "1.5.0"
    }
  ]
}
