Skip to main content
PATCH
/
integrations
/
linear
/
{conversation_id}
/
tickets
/
{linear_id}
Update a Linear issue
curl --request PATCH \
  --url https://api.getfernand.com/integrations/linear/{conversation_id}/tickets/{linear_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "priority": 2
}'
{
  "id": "8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b",
  "title": "Fix authentication bug",
  "url": "https://linear.app/team/issue/ENG-123",
  "identifier": "ENG-123",
  "assignee": {
    "name": "Richard Hendricks",
    "avatar_url": "https://avatar.linear.app/9c0d1e2f"
  },
  "state": {
    "name": "In Progress",
    "type": "started",
    "color": "#f2c94c",
    "verbose": "2024-01-15T10:30:00+00:00",
    "last_updated_at": "2024-01-15T10:30:00Z"
  },
  "labels": [
    {
      "name": "bug",
      "color": "#5e6ad2"
    }
  ],
  "priority": 2,
  "priority_label": "High",
  "last_updated_at": "2024-01-15T10:30:00Z"
}
Updates properties of a Linear issue that is attached to the specified conversation. Currently only supports updating the priority level of the issue. The priority must be a valid value between 0 (No priority) and 4 (Low). Returns the updated issue details.

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Path Parameters

​
conversation_id
integer
required

ID of the conversation the issue is attached to.

​
linear_id
string<uuid>
required

UUID of the Linear issue to update.

Body

application/json
​
priority
integer
required

Priority level - 0 (No priority), 1 (Urgent), 2 (High), 3 (Medium), 4 (Low) (required).

Example:

2

Response

Linear issue updated successfully.

​
id
string

Unique identifier of the Linear issue.

Example:

"8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b"

​
title
string

Title of the issue.

Example:

"Fix authentication bug"

​
url
string

URL to view the issue in Linear.

Example:

"https://linear.app/team/issue/ENG-123"

​
identifier
string

Human-readable issue identifier.

Example:

"ENG-123"

​
assignee
object

Assigned user (null if unassigned).

​
state
object

Current workflow state of the issue.

​
labels
object[]

List of labels applied to the issue.

​
priority
integer

Priority level (0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low).

Example:

2

​
priority_label
string

Display name of the priority level.

Example:

"High"

​
last_updated_at
string

ISO 8601 timestamp of the last update.

Example:

"2024-01-15T10:30:00Z"