Update issue

Update an issue, synced to Linear. Linear sync failures are logged but do not block the local update. Requires the issues:write scope.

PATCH

/api/v2/issues/{id}

PATCH

/issues/{id}

curl -X PATCH "https://productlane.com/api/v2/issues/{id}" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "description": "string",
  "state_id": "string",
  "priority": 0,
  "project_id": "string",
  "assignee_id": "string",
  "is_visible": true,
  "portal_instance_ids": [
    "string"
  ]
}'

Authorization

Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parameters

id
string
path
required

Body

application/json

title
string
description
string
Appended to the issue description; the existing description is never overwritten.
state_id
string
Linear workflow state id.
priority
any of
Linear issue priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
project_id
string | null
Linear project id. Pass null to detach.
assignee_id
string | null
Linear user id. Pass null to unassign.
is_visible
boolean
Whether the issue is shown on the customer portal.
portal_instance_ids
string[]
Every portal the item is on, from GET /portal/instances. Use "__main__" for the Main portal. Replaces the current list. The item shows on these portals only while is_visible is true.

Response

application/json

Successful response

id
string
required
identifier
string
required
title
string
required
description
string | null
required
priority
string
required
status
string
required
linear_team_id
string
required
url
string
required
project_id
string | null
required
sort_order
number
required
total_score
number
required
is_visible
boolean | null
required
portal_instance_ids
string[]
required
created_at
string
required
updated_at
string
required
linear_ticket_id
string
required

{
  "id": "string",
  "identifier": "string",
  "title": "string",
  "description": "string",
  "priority": "string",
  "status": "string",
  "linear_team_id": "string",
  "url": "string",
  "project_id": "string",
  "sort_order": 0,
  "total_score": 0,
  "is_visible": true,
  "portal_instance_ids": [
    "string"
  ],
  "created_at": "string",
  "updated_at": "string",
  "linear_ticket_id": "string"
}

PATCH

/issues/{id}

curl -X PATCH "https://productlane.com/api/v2/issues/{id}" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "description": "string",
  "state_id": "string",
  "priority": 0,
  "project_id": "string",
  "assignee_id": "string",
  "is_visible": true,
  "portal_instance_ids": [
    "string"
  ]
}'

{
  "id": "string",
  "identifier": "string",
  "title": "string",
  "description": "string",
  "priority": "string",
  "status": "string",
  "linear_team_id": "string",
  "url": "string",
  "project_id": "string",
  "sort_order": 0,
  "total_score": 0,
  "is_visible": true,
  "portal_instance_ids": [
    "string"
  ],
  "created_at": "string",
  "updated_at": "string",
  "linear_ticket_id": "string"
}

- Introduction
- Authentication
- MCP Server
- Errors
- Rate limits
- Pagination
- Article content
- Webhooks
- Migrating from API v1 to v2

APIIssues

Update issue

Update an issue, synced to Linear. Linear sync failures are logged but do not block the local update. Requires the issues:write scope.

PATCH

/api/v2/issues/{id}

PATCH

/issues/{id}

curl -X PATCH "https://productlane.com/api/v2/issues/{id}" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "description": "string",
  "state_id": "string",
  "priority": 0,
  "project_id": "string",
  "assignee_id": "string",
  "is_visible": true,
  "portal_instance_ids": [
    "string"
  ]
}'

Authorization

Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parameters

id
string
path
required

Body

application/json

title
string
description
string
Appended to the issue description; the existing description is never overwritten.
state_id
string
Linear workflow state id.
priority
any of
Linear issue priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low.
project_id
string | null
Linear project id. Pass null to detach.
assignee_id
string | null
Linear user id. Pass null to unassign.
is_visible
boolean
Whether the issue is shown on the customer portal.
portal_instance_ids
string[]
Every portal the item is on, from GET /portal/instances. Use "__main__" for the Main portal. Replaces the current list. The item shows on these portals only while is_visible is true.

Response

application/json

Successful response

id
string
required
identifier
string
required
title
string
required
description
string | null
required
priority
string
required
status
string
required
linear_team_id
string
required
url
string
required
project_id
string | null
required
sort_order
number
required
total_score
number
required
is_visible
boolean | null
required
portal_instance_ids
string[]
required
created_at
string
required
updated_at
string
required
linear_ticket_id
string
required

{
  "id": "string",
  "identifier": "string",
  "title": "string",
  "description": "string",
  "priority": "string",
  "status": "string",
  "linear_team_id": "string",
  "url": "string",
  "project_id": "string",
  "sort_order": 0,
  "total_score": 0,
  "is_visible": true,
  "portal_instance_ids": [
    "string"
  ],
  "created_at": "string",
  "updated_at": "string",
  "linear_ticket_id": "string"
}

PATCH

/issues/{id}

curl -X PATCH "https://productlane.com/api/v2/issues/{id}" \
  -H "Authorization: Bearer $PRODUCTLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "description": "string",
  "state_id": "string",
  "priority": 0,
  "project_id": "string",
  "assignee_id": "string",
  "is_visible": true,
  "portal_instance_ids": [
    "string"
  ]
}'

{
  "id": "string",
  "identifier": "string",
  "title": "string",
  "description": "string",
  "priority": "string",
  "status": "string",
  "linear_team_id": "string",
  "url": "string",
  "project_id": "string",
  "sort_order": 0,
  "total_score": 0,
  "is_visible": true,
  "portal_instance_ids": [
    "string"
  ],
  "created_at": "string",
  "updated_at": "string",
  "linear_ticket_id": "string"
}