{
  "$schema": "https://agents-json.com/schema/v1",
  "info": {
    "title": "Hireex Waitlist API",
    "version": "1.0.0",
    "description": "Hireex is a pre-launch consumer SaaS for job seekers. The public HTTP surface today is the waitlist landing. There is no public agent API; the two endpoints described here exist solely to operate the waitlist signup form and the RFC 8058 one-click unsubscribe flow."
  },
  "servers": [
    {
      "url": "https://hireex.ai",
      "description": "Production landing"
    }
  ],
  "flows": [
    {
      "name": "join-waitlist",
      "description": "Add an email to the Hireex founding-member waitlist. Idempotent: re-submitting the same address returns status: already_subscribed.",
      "steps": [
        {
          "action": "POST /api/notify",
          "description": "Submit a single email address",
          "input": {
            "email": "string"
          },
          "output": {
            "ok": "boolean",
            "status": "subscribed | already_subscribed | noop"
          }
        }
      ]
    },
    {
      "name": "one-click-unsubscribe",
      "description": "RFC 8058 one-click unsubscribe. Mail clients (Gmail, Apple Mail) hit POST when the inbox-level unsubscribe button is pressed; humans clicking a link in the email get GET with a small confirmation page.",
      "steps": [
        {
          "action": "POST /api/unsubscribe",
          "description": "Verify HMAC-signed link parameters and PATCH the contact in Resend",
          "input": {
            "a": "audienceId",
            "e": "email",
            "x": "expiry-unix",
            "t": "hmac-token"
          },
          "output": {
            "ok": "boolean"
          }
        }
      ]
    }
  ],
  "links": {
    "homepage": "https://hireex.ai",
    "blog": "https://hireex.ai/blog",
    "rss": "https://hireex.ai/rss.xml",
    "openapi": "https://hireex.ai/openapi.yaml",
    "llms": "https://hireex.ai/llms.txt",
    "llms-full": "https://hireex.ai/llms-full.txt",
    "agents-md": "https://hireex.ai/AGENTS.md",
    "structured-data": "https://hireex.ai/structured-data.json"
  },
  "notes": "No public agent API exists for end-user job search yet; the product is pre-launch waitlist. Do not invoke /api/notify on behalf of users without their explicit consent — it stores the address in the Resend hireex audience."
}