{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/hokai-io/json-schema/hokai-io-post-api-agent-guide-spot-request-schema.json",
  "title": "PostApiAgentGuideSpotRequest",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/hokai-io-openapi-generated.yml#/components/schemas/PostApiAgentGuideSpotRequest",
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "a work email"
    },
    "guide": {
      "type": "string",
      "description": "a guide slug from guides[] below"
    },
    "product": {
      "type": "string",
      "description": "required: {\"type\":\"tools\",\"slug\":\"<hokai slug>\"} for a product already on Hokai, or {\"name\":\"...\",\"url\":\"https://...\"} for one that is not"
    },
    "starts_on": {
      "type": "string",
      "description": "optional, YYYY-MM-DD (default: the guide's next free day)"
    },
    "months": {
      "type": "string",
      "description": "optional, one of 3, 6, 12 (default 3)"
    },
    "company": {
      "type": "string",
      "description": "optional"
    },
    "agent": {
      "type": "string",
      "description": "optional, your agent's name"
    }
  },
  "required": [
    "email",
    "guide",
    "product"
  ]
}