# HaloWerk HowTo Entity Decision

> HaloWerk HowTo Entity Decision is a paid API for AI agents from agentreadiness.halowerk.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Passively evaluates whether a public URL correctly exposes HowTo structured-data entities and returns an evidence-backed verdict with source, limitations, and recommended action.

## Facts

- Endpoint: POST https://agentreadiness.halowerk.com/v1/howto-entity-decision?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-howto-entity-decision-b8bc1548
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UwHbJX5XYc4fInyQ3IsZ0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability halowerk-howto-entity-decision-b8bc1548 -d '<json body>'
```

Example prompt: Can you check whether https://www.example.com/how-to-bake-bread has valid HowTo structured-data entities — I want a verdict on whether it meets the threshold, what evidence was found, and what action I should take if it fails?

## When to prefer this

Use this endpoint when you need a fast, passive, evidence-backed verdict specifically on HowTo schema.org structured-data entities for a given public URL, without performing any login, form submission, or active exploit. Prefer this over generic SEO auditors when you need a machine-readable verdict with explicit evidence sourcing and action recommendations tailored to agent-readiness workflows.

## Known failure modes

- Target URL is unreachable or returns non-200 status — verdict may be inconclusive
- Target blocks crawlers via robots.txt or firewall — evidence unavailable
- No HowTo entity found on the page — verdict is fail with empty observation
- Malformed or ambiguous HowTo markup — partial evidence returned with limitations noted
- Network timeout on slow-loading targets — incomplete response

## How this service works

HowTo entity decision fetches current public evidence from the supplied target and evaluates the documented criterion. It returns the observation, threshold, verdict, exact evidence source, limitations and a mode-specific action. The check is passive: no login attempt, payload injection, exploit, purchase, form submission or load test is performed.

## Output

Returns a structured object containing: the observation (what was found on the target), the threshold used for evaluation, the verdict (pass/fail/inconclusive), the exact evidence source URL, noted limitations of the passive check, and a mode-specific action recommendation for remediation or confirmation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "target": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Public HTTP(S) URL or domain to inspect. A bare domain is normalized to HTTPS."
  },
  "context": {
   "type": "object",
   "description": "Optional non-secret correlation labels returned unchanged only in the request lifecycle.",
   "maxProperties": 12,
   "additionalProperties": {
    "type": [
     "string",
     "number",
     "boolean",
     "null"
    ]
   }
  },
  "baseline": {
   "type": [
    "object",
    "null"
   ],
   "description": "Optional baseline returned by a previous snapshot call.",
   "additionalProperties": true
  },
  "compare_url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 3,
   "description": "Optional public comparison URL. Used by change and monitoring services."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-howto-entity-decision-b8bc1548/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentreadiness.halowerk.com](https://www.zero.xyz/host/agentreadiness.halowerk.com/llms.txt)