Skip to main content
PUT
/
integrations
/
linear
/
{conversation_id}
/
tickets
/
{linear_id}
Attach a Linear issue to a conversation
curl --request PUT \
  --url https://api.getfernand.com/integrations/linear/{conversation_id}/tickets/{linear_id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b",
  "title": "Fix authentication bug",
  "url": "https://linear.app/team/issue/ENG-123",
  "identifier": "ENG-123",
  "assignee": {
    "name": "John Doe",
    "avatar_url": "https://avatar.linear.app/9c0d1e2f"
  },
  "state": {
    "name": "In Progress",
    "type": "started",
    "color": "#f2c94c",
    "verbose": "2026-01-15T10:30:00+00:00",
    "last_updated_at": "2026-01-15T10:30:00Z"
  },
  "labels": [
    {
      "name": "bug",
      "color": "#5e6ad2"
    }
  ],
  "attachments": [
    {
      "id": "2f3a4b5c-6d7e-8f9a-0b1c-2d3e4f5a6b7c",
      "url": "https://app.getfernand.com/conversations/12345"
    }
  ],
  "priority": 1,
  "priority_label": "Urgent",
  "last_updated_at": "2026-01-15T10:30:00Z"
}
Attaches an existing Linear issue to the specified conversation. The issue must exist at Linear. An attachment and customer link are added to the issue linking it to the conversation in Fernand. Returns a 404 error if the issue cannot be found.

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 to attach the issue to.

​
linear_id
string<uuid>
required

UUID of the Linear issue to attach.

Response

Linear issue attached 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.

​
attachments
object[]

List of attachments on the issue.

​
priority
integer

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

Example:

1

​
priority_label
string

Display name of the priority level.

Example:

"Urgent"

​
last_updated_at
string

ISO 8601 timestamp of the last update.

Example:

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