Danu Astrology

Use this when someone wants to know how two people fit astrologically (partners, friends, family, coworkers) and gives birth details for both. Works without a Danu account. Needs each person's birth date and birthplace; birth time is optional. Ask for missing birth details instead of guessing. If the user has linked Danu and the person is already in their Circle, use danu_pair_reading instead.

{
  "type": "object",
  "properties": {
    "person_a": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "First name is enough."
        },
        "birth_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Birth date, YYYY-MM-DD."
        },
        "birth_time": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
            },
            {
              "type": "null"
            }
          ],
          "description": "Birth time, 24-hour HH:MM. Omit if unknown; never guess."
        },
        "birthplace": {
          "type": "string",
          "minLength": 2,
          "maxLength": 120,
          "description": "City plus region or country, e.g. 'Springfield, Illinois'."
        }
      },
      "required": [
        "name",
        "birth_date",
        "birthplace"
      ],
      "additionalProperties": false
    },
    "person_b": {
      "type": "object",
      "properties": {
        "name": {
          "$ref": "#/properties/person_a/properties/name"
        },
        "birth_date": {
          "$ref": "#/properties/person_a/properties/birth_date"
        },
        "birth_time": {
          "$ref": "#/properties/person_a/properties/birth_time"
        },
        "birthplace": {
          "$ref": "#/properties/person_a/properties/birthplace"
        }
      },
      "required": [
        "name",
        "birth_date",
        "birthplace"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "person_a",
    "person_b"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks about their own chart, their big three, their role, or what is hitting their chart now. Requires a linked Danu account.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user wants to see their Circle (family, friends, partner, team), everyone's role in the group, what the group runs on or lacks, or 'who is the X of my family/friends'. Requires a linked Danu account.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks about their dynamic with a specific person already in their Danu Circle (why they clash, how to talk to them, whether to raise something). Pass the person's name as 'who'. Pass 'situation' with what is actually going on, in the user's words, so the reading is about their life. Requires a linked Danu account.

{
  "type": "object",
  "properties": {
    "who": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Name or relationship of the person in their Circle, e.g. 'Mom' or 'Sam'. If Danu answered with labels like 'Sam (friend)', pass the chosen label exactly."
    },
    "situation": {
      "type": "string",
      "maxLength": 600,
      "description": "What's going on between them right now, from the conversation. Not stored."
    }
  },
  "required": [
    "who"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user asks who in their Circle is having a hard week, who to check in on, when to ask someone for something, or for a weekly forecast for their family or friends. Requires a linked Danu account.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user wants to add a person to their Danu Circle and has that person's birth date and birthplace (birth time optional). Confirm the details back before calling. If they don't know the birthday, use danu_create_compare_link instead. Requires a linked Danu account.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "First name is enough."
    },
    "birth_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Birth date, YYYY-MM-DD."
    },
    "birth_time": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Birth time, 24-hour HH:MM. Omit if unknown; never guess."
    },
    "birthplace": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "City plus region or country, e.g. 'Springfield, Illinois'."
    },
    "relationship": {
      "type": "string",
      "enum": [
        "partner",
        "husband",
        "wife",
        "ex",
        "crush",
        "parent",
        "child",
        "sibling",
        "friend",
        "colleague",
        "boss",
        "other"
      ],
      "description": "How this person relates to the user."
    }
  },
  "required": [
    "name",
    "birth_date",
    "birthplace",
    "relationship"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user wants to compare with someone but doesn't know their birth details, or wants that person to see the result too. Creates a single-use link; the person enters their own birthday and joins the user's Circle with consent. Requires a linked Danu account.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "The person's name."
    },
    "relationship": {
      "type": "string",
      "enum": [
        "partner",
        "husband",
        "wife",
        "ex",
        "crush",
        "parent",
        "child",
        "sibling",
        "friend",
        "colleague",
        "boss",
        "other"
      ],
      "description": "How this person relates to the user."
    }
  },
  "required": [
    "name",
    "relationship"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when the user wants to share their Circle roles (for a group chat or social post). Creates a public link that shows first names and roles only, never birth details. Requires a linked Danu account.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}