Agents

AI agents now sign up, start trials and claim credits for real people. AbuseZero recognizes agents that can prove who they are, by name, on every evaluation. This endpoint lists every agent AbuseZero recognizes. AbuseZero maintains the list.

You decide, benefit by benefit, which recognized agents may claim a benefit: list their IDs in the benefit's allowed_agents setting. Read the IDs from this endpoint instead of hard-coding them. Automation that can't prove what it is gets no such pass. For the concept, see Bots and AI agents. To recognize agents on your own server, see Verify AI agents.

The agent objectCopy Anchor Link

{
  "object": "agent",
  "id": "<agent ID>",
  "name": "<agent name>"
}

List recognized agentsCopy Anchor Link

Also available as abusezero agents list in the AbuseZero CLI, abusezero_list_agents on the AbuseZero MCP server and agents() in the AbuseZero Node.js SDK.

ExampleCopy Anchor Link

import { AbuseZero } from "abusezero/server";

const abusezero = new AbuseZero({ key: process.env.ABUSEZERO_SECRET_KEY!, outage: "throw" });

const agents = await abusezero.agents();

ResponseCopy Anchor Link

Returns 200. Every recognized agent comes back in one response, so next_cursor is always null.

{
  "object": "list",
  "data": [
    {
      "object": "agent",
      "id": "<agent ID>",
      "name": "<agent name>"
    }
  ],
  "next_cursor": null
}

For error codes, see REST API errors.

RelatedCopy Anchor Link