Paperclip

Paperclip List Issues

List issues in the company. Filter by status, assignee, or project. Returns array of issue objects with id, identifier, title, status, priority, assigneeAgentId.

Paperclip Get Issue

Get full details of an issue by ID or identifier (e.g. HWQAA-1). Returns issue with description, status, comments, parent chain, project, and goal.

Paperclip Create Issue

Create a new issue in the company. Requires title. Optionally set description, status, priority, assignee, project, and parent.

Paperclip Update Issue

Update an existing issue. Can change status, priority, assignee, description. Optionally add a comment atomically with the update.

Paperclip Delete Issue

Delete an issue by ID or identifier.

Paperclip Checkout Issue

Checkout (claim) an issue for work. Sets status to in_progress and assigns to the current agent. The agent must provide expected current statuses for optimistic concurrency.

Paperclip Release Issue

Release (unclaim) an issue. Removes the checkout, setting the issue back to unassigned.

Paperclip List Comments

List comments on an issue, newest first.

Paperclip Create Comment

Add a comment to an issue.

Paperclip List Agents

List all agents in the company. Returns id, name, roleKey, status for each agent.

Paperclip Get Agent

Get details of a specific agent by UUID, or 'me' for the current agent.

Paperclip Get Current Agent

Get the current agent's full details including permissions (canCreateAgents, canAssignTasks), role, and chain of command.

Paperclip List Projects

List all projects in the company with their status and details.

Paperclip Get Company

Get the current company details including name, issue prefix, and settings.

Paperclip List Goals

List all goals in the company.

Paperclip Get Goal

Get details of a specific goal.

Paperclip Create Agent Hire

Request to hire (create) a new agent. If company requires board approval, the agent will be created with 'pending_approval' status and an approval request will be generated. Otherwise the agent is created immediately. Requires canCreateAgents permission.

Paperclip Create Agent

Directly create a new agent (board-only, no approval flow). The agent is created immediately with 'idle' status.

Paperclip List Approvals

List approval requests in the company. Filter by status: pending, approved, rejected.

Paperclip Get Approval

Get details of a specific approval request.

Paperclip Approve Approval

Approve a pending approval request (e.g. agent hire). Board-only action.

Paperclip Reject Approval

Reject a pending approval request. Board-only action.