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.
Request
- Base URL: https://api.tryfuse.ai/api/v1
- URL: https://api.tryfuse.ai/api/v1/business/agents
- Auth: HTTP basic
Query parameters
Page size: how many agents to return per page (1-100, default 25).
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.