paperclip_list_agents
Read-only
List all agents in your company with pagination support to resolve agent names to UUIDs for issue assignment or heartbeat operations.
Instructions
List all agents in the current company.
Returns: Pagination envelope { items: Agent[], total, count, offset, limit, has_more, next_offset } with up to 50 agents per page (default, max 100).
Examples:
Use when: resolving an agent name to a UUID before assigning an issue or invoking a heartbeat
Don't use when: you need full agent details — use paperclip_get_agent with the resolved ID
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → verify PAPERCLIP_COMPANY_ID is correct
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | Max agents per page (1–100, default 50) | |
| offset | Yes | Number of agents to skip (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |