Documentation Agent HTTPGet reference item tool

Get reference item tool

POST/agent/v1/tools/get-reference-itemAgent HTTPFrom Free

Load a gate, channel, center or profile for an agent.

Give assistants concise, structured Human Design reference knowledge through a free, non-consuming lookup without navigating REST collections.

Authentication

Use Authorization: Bearer YOUR_API_KEY or X-Api-Key. Query-key authentication is deprecated compatibility behavior on supported REST routes and is rejected on Agent HTTP and MCP surfaces. Never put credentials in URLs, request bodies, or browser code.

Parameters

Name	In	Required	Description
`Authorization`	header	Yes	Bearer API key. X-Api-Key is also supported. `Bearer YOUR_API_KEY`
`kind`	body	Yes	Reference kind: gate, channel, center or profile. `gate`
`id`	body	Yes	Reference identifier. `48`

Quota effect

This is a free, non-consuming lookup. Authorized calls use 0 calculation units.

Errors

Expect 400 for invalid input, 401 for a missing or malformed key, 403 when the active plan does not include this operation, and 429 when the monthly allowance is exhausted.

Related operations

RequestcURL

curl -X POST "https://api.humandesign.ai/agent/v1/tools/get-reference-item" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "gate",
  "id": 48
}'

Verified response examplecURL

{
  "version": "v1",
  "tool": "get_reference_item",
  "data": {
    "gate": 48,
    "name": "The Well",
    "iChingName": "The Well (Ching)",
    "iChingHexagram": 48,
    "geneKeys": {
      "shadow": "Inadequacy",
      "gift": "Resourcefulness",
      "siddhi": "Wisdom"
    },
    "center": "Spleen",
    "circuit": "Collective",
    "subcircuit": "Logic",
    "keynote": "The Gate of Depth",
    "description": "The intuitive depth and fear of inadequacy.",
    "harmonicGate": 16,
    "channel": "16-48 Channel of the Wavelength",
    "lines": {
      "1": {
        "name": "Insignificance",
        "theme": "Feeling small"
      },
      "2": {
        "name": "Degeneracy",
        "theme": "Declining depth"
      },
      "3": {
        "name": "Incommunicado",
        "theme": "Isolated depth"
      },
      "4": {
        "name": "Restructuring",
        "theme": "Rebuilding resources"
      },
      "5": {
        "name": "Action",
        "theme": "Using depth"
      },
      "6": {
        "name": "Self-Fulfillment",
        "theme": "Complete resourcefulness"
      }
    }
  },
  "meta": {
    "surface": "agent_http",
    "operation": "get_reference_item",
    "requiredTier": "creator",
    "tool": {
      "kind": "gate",
      "id": "48"
    }
  },
  "error": null
}

Captured from the live API on 6 August 2026. 43/43 live checks passed. Secrets and account-specific usage are removed; large payloads show a truthful excerpt.

Free includes 100 calls every month.
Free members can use every operation labelled “From Free,” including the core Agent HTTP and MCP tools.