Agents

The token owner's agents across every kind

Your agents of every kind, newest created first, one page at a time. type is the public slug (the same one you POST to at /business/agents/{type}); status is initializing for a saved draft, then processing / active / paused / expired / failed; older agents can also read completed or deleted. contactsFound is how many results the agent has delivered so far and listId is the list holding them — read the rows with the Lists endpoints. sourceListIds is filled only for the watcher kinds, which watch an existing list. Use limit (1-100, default 25) and pageNum with pagination.totalPages to walk the whole set. The agent's config is not included here: read it with GET /business/agents/{agentId}.

Errors:

  • 422 VALIDATION_FAILED — The request failed this endpoint's own validation — param names the offending field and message says why.
  • 429 RATE_LIMITED — The agents bucket is exhausted: 30 requests per minute or 2,000 per day per token owner, shared by every /business/agents operation (a 429 raised by the agents service is relayed with this code too). Retry after the Retry-After header.
  • 500 UNEXPECTED_ERROR — The agents service failed (5xx, refused service credential, or a timeout after 60s) or the rate limiter was unavailable. Retry later; quote request_id to support.

Requires one of the following token scopes: agents.

get/business/agents

Request

  • Base URL: https://api.tryfuse.ai/api/v1
  • URL: https://api.tryfuse.ai/api/v1/business/agents
  • Auth: HTTP basic

Query parameters

limitinteger

Page size: how many agents to return per page (1-100, default 25).

pageNuminteger

1-based page number (default 1); agents are ordered newest-created first. pagination.totalPages tells you when to stop.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.