Skip to content

Beta: these docs are still being updated. The next full update is on 18 November at 8 PM UTC. Docs in beta. Full update 18 Nov, 8 PM UTC.

Hoody.com

Lookup tables for Bot URL status, access log and lifecycle.

For supported Bot operations that require a key, Off, Frozen, Detached and suspended URLs return key_invalid without a valid key and bot_disabled with one. Keyless GET / and GET /SKILL.md remain available. CORS preflights on supported paths are also keyless: they succeed when browser access is enabled, or return cors_disabled, unless Bot URLs are switched off on the server or everywhere.

The following availability errors can also be returned without a key:

CaseEvery request gets
Bot URLs switched off on the computer’s server (host_off) or everywhere (global_off)bot_disabled
A label that does not exist, and a detached or deleted URL once its address is gonebot_not_found

Each line holds metadata only:

FieldValue
tsMs, durationMs, status, bytesSentWhen, how long, the HTTP status and the size of the answer
method, urlThe method and the path, such as POST /v1/chat/completions. Never the query string, so never a ?key=.
clientIpThe caller’s IPv4 address
traceIdThe request id the caller received in X-Request-Id
serviceNamebots
data.bot_exposureThe id of the Bot URL that was called, bu_…
data.bot_labelWhen present, the label that was called
data.bot_caller, data.bot_caller_nameThe key’s id and name, or null when no valid key was sent
data.bot_dooropenai, anthropic, mcp, manual (GET /), skill (GET /SKILL.md), preflight (a browser OPTIONS) or other
data.bot_resultok, client_closed (the caller left before the answer was complete), request_timeout (the request body paused for more than 30 seconds and the connection was closed with no answer), or the error code the caller received
data.bot_limitOn a limit refusal: which limit, {scope, kind, max, retry_at}
WhatDetail
Refusals that leave no lineA plain http:// request, a request over IPv6, a malformed address, a call to the server the URL was moved away from, a call refused because a Hoody service was unavailable before the URL could be identified
Lost linesA line can occasionally be lost on its way
Logged nowhereCalls to a label that does not exist, and calls to a detached or deleted URL
RetentionThe proxy logs’ retention, by default 7 days, 50,000 entries or 100 MB per computer, whichever comes first
RuleDetail
Numeric filtersSend each of afterId, last, limit, offset, sinceMs, untilMs once, as a whole number without a sign or fraction
Minimumslast and limit at least 1, the others at least 0
A repeated or invalid value400 INVALID_QUERY_PARAMETER; error names the argument. An empty value, such as ?last=, counts as not sent
lastReturns at most 1000 entries, even when you ask for more
A password group protects the logsSend its username and password with HTTP Basic auth; without valid credentials the answer is 401
CachingLog results and the 400, 429 and 503 responses carry Cache-Control: private, no-store

The other filters and the live stream are on Proxy Logs.

What happensThe URLCallers get
You turn the URL off, or back onOff. Turning off preserves any stronger status. Changing the switch from off to on is refused with 409 BOT_URL_FROZEN while frozen; otherwise the status is worked out again, and a suspension can keep it Offbot_disabled, or answers when the URL is Active
You change CORS or limitsThe status does not changeThe new settings, within about 11 seconds after they are applied
You re-point it to another computerRefused with 409 BOT_URL_FROZEN while frozen. Otherwise attached to the new computer; your on/off switch and any suspension still applyAnswers from the new Bot when the URL is Active
The computer is deleted, or the server it was on ends or is no longer yoursFrozen if it already was; otherwise Detached. Label and keys keptbot_disabled for a caller with a valid key, then bot_not_found
You re-point a detached URLRefused while frozen; otherwise attached again, with status worked out from your on/off switch and any suspensionAnswers when the URL is Active
You delete the URLGone; the label stays taken foreverbot_not_found
The project, your account or the server is deletedGone; the label stays taken foreverbot_not_found
Hoody freezes or unfreezes itFrozen; after unfreezing, whatever its current settings givebot_disabled, or answers again if nothing else turned it off
A suspension starts or endsFrozen and Detached keep their status; otherwise Off (suspended). After it ends, whatever its current settings givebot_disabled, or answers again if nothing else turned it off
You press panicOff, unless Frozen, Detached or a suspension applies; every key revokedkey_invalid
The Bot is deleted or recreated in the agentStatus unchangedbot_disabled for requests forwarded to the Bot with a valid key, until you re-point; GET /v1/key still returns the key’s name and holder note while the URL is Active

While a former server has not stopped serving the old address, the move remains blocked. propagation.state can be pending or failed. An entry in propagation.deny_targets with blocking: true identifies a blocking former server when its details are available. The move can complete after that server stops serving the address or Hoody removes it from service.