Skip to main content
GET
/
integrations
/
linear
/
{conversation_id}
/
tickets
Get Linear issues attached to a conversation
curl --request GET \
  --url https://api.getfernand.com/integrations/linear/{conversation_id}/tickets \
  --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": "Richard Hendricks",
      "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"
  }
]
Returns a list of Linear issues attached to the specified conversation. Returns a 404 error if the Linear integration is not configured for the organization.

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 retrieve issues for.

Response

Linear issues retrieved 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"