paperclip_update_issue
Update issue fields and optionally add a comment in a single call. Change status, priority, assignee, project, goal, labels, and other properties.
Instructions
Update one or more fields on an issue; optionally attach a comment in the same call.
Args:
issueId: string — Issue ID or identifier (example: "PAP-42")
status: enum — backlog|todo|in_progress|in_review|done|blocked|cancelled
priority: enum — critical|high|medium|low
title: string — New title
description: string — New description (markdown)
comment: string — Comment to post with this update
assigneeAgentId: string|null — Agent UUID; null to unassign
assigneeUserId: string|null — User UUID; null to unassign
goalId: string|null — Goal UUID; null to unlink
projectId: string|null — Project UUID; null to unlink
parentId: string|null — Parent issue UUID; null to detach
billingCode: string|null — Billing code; null to clear
labelIds: string[] — Replaces label set; [] clears all
executionRunId: string|null — null to clear stale run lock
executionLockedAt: string|null — ISO lock timestamp; null to clear
Returns: Returns the updated issue object with all fields.
Examples:
Use when: transitioning an issue to in_review and posting a @QA comment in one call
Don't use when: you need to claim the issue — use paperclip_checkout_issue first
Error Handling:
400: validation failure → check status/priority enum values and field types
401: authentication failed → check PAPERCLIP_API_KEY
404: issue not found → verify ID with paperclip_list_issues
422: invalid state transition → check current status with paperclip_get_issue
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issueId | Yes | Issue ID or identifier (e.g. PAP-21) | |
| status | No | New status | |
| comment | No | Comment to add alongside the update | |
| priority | No | New priority level | |
| title | No | New title | |
| description | No | New description (markdown) | |
| assigneeAgentId | No | Assignee agent UUID; null to unassign | |
| assigneeUserId | No | Assignee user UUID; null to unassign | |
| goalId | No | Goal UUID; null to unlink | |
| projectId | No | Project UUID; null to unlink | |
| parentId | No | Parent issue UUID; null to unlink | |
| billingCode | No | Billing code for cost tracking; null to clear | |
| labelIds | No | Label UUIDs to set (replaces existing set); pass [] to clear all labels | |
| executionRunId | No | Execution run ID holding the checkout lock; pass null to clear a stale lock | |
| executionLockedAt | No | ISO timestamp of when the execution lock was acquired; pass null to clear |