Skip to navigation
Developer ReferenceAgent ReferenceAll Agents

Link Integrity

API name: link_integrity · Category: Accuracy

Check every hyperlink and bare URL for anchor/URL mismatches, dead destinations, domain decay, misattributed citations, and off-topic links. For what this agent does and why it matters, see Link Integrity in the Agent Catalog.

What it returns

The run status plus one issue per flagged link — its location in the text, the issue type, and the risk level. The agent reports findings only; it does not return replacement URLs. It checks the first 50 links per run and warns when it hits that cap. Because links are fetched over the network, runs take longer than text-only agents — prefer the async flow for anything longer than a short document.

Run this agent

Agents are run by ID, but you never need to hardcode one: resolve the ID from the agent’s stable name (link_integrity) with GET /agents, then call POST /agents/{agent_id}/run. Pass wait=true to block until the run completes; omit it to get a workflow_id back immediately and track the run with GET /agents/workflows/{workflow_id} (or a webhook_url in the request body).

TOKEN="YOUR_TOKEN"
# Resolve the agent ID by name
AGENT_ID=$(curl -s "https://api.markup.ai/agents?page_size=100" \
  -H "Authorization: Bearer $TOKEN" \
  | jq -r '.agents[] | select(.name == "link_integrity") | .id')
# Run the agent and wait for the result
curl -X POST "https://api.markup.ai/agents/$AGENT_ID/run?wait=true" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Your content to check."}'

Prefer MCP? On the hosted MCP server, run this agent with markupai_run_agents and agents: ["link_integrity"], or let markupai_review select it from your goal — see the MCP overview.