Documentation Agent HTTPResolve timezone tool

Resolve timezone tool

POST/agent/v1/tools/resolve-timezoneAgent HTTPFrom Free

Resolve a place name for an AI agent.

A predictable, non-consuming lookup that translates a human location query into timezone and geographic candidates before calculation.

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`
`query`	body	Yes	City or location search query. `Edinburgh`

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/resolve-timezone" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "Edinburgh"
}'

Verified response examplecURL

{
  "version": "v1",
  "tool": "resolve_timezone",
  "data": [
    {
      "country": " United Kingdom",
      "timezone": "Europe/London",
      "asciiname": "Edinburgh",
      "admin1": " Scotland",
      "tokens": [
        "Edinburgh",
        " Scotland"
      ],
      "value": "Edinburgh, Scotland, United Kingdom"
    },
    {
      "country": " Saint Helena",
      "timezone": "Atlantic/St_Helena",
      "asciiname": "Edinburgh of the Seven Seas",
      "admin1": " Tristan da Cunha",
      "tokens": [
        "Edinburgh of the Seven Seas",
        " Tristan da Cunha"
      ],
      "value": "Edinburgh of the Seven Seas, Tristan da Cunha, Saint Helena"
    }
  ],
  "meta": {
    "surface": "agent_http",
    "operation": "resolve_timezone",
    "requiredTier": "creator",
    "tool": {
      "query": "Edinburgh",
      "resultCount": 2
    }
  },
  "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.