paperclip_get_activity
Retrieve the audit trail activity feed for your company, with options to filter by agent, entity type, or entity ID.
Instructions
Get the audit trail activity feed for the current company.
Args:
agentId: string (optional) — Filter to a specific agent (example: "agt_abc123")
entityType: string (optional) — Filter by entity kind (example: "issue")
entityId: string (optional) — Filter to a specific entity (example: "PAP-42")
response_format: 'markdown' | 'json' (optional) — Output format (default: markdown)
Returns: Pagination envelope { items: ActivityEvent[], total, count, offset, limit, has_more, next_offset }. Each item: id, agentId, entityType, entityId, action, occurredAt, metadata.
Examples:
Use when: auditing what an agent did on a specific issue or reviewing recent company actions
Don't use when: you need issue comments — use paperclip_list_comments instead
Error Handling:
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → verify PAPERCLIP_COMPANY_ID is correct
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentId | No | Filter by agent ID | |
| entityType | No | Filter by entity type (e.g. issue, approval) | |
| entityId | No | Filter by entity ID | |
| limit | Yes | Max events per page (1–100, default 50) | |
| offset | Yes | Number of events to skip (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |