Attachment
All issue attachments. To get attachments for a given URL, use `attachmentsForURL` query.
Table-Specific Information
SELECT
The driver uses the Linear API to process WHERE clause conditions built with the following columns and operators. The rest of the filter is executed client-side within the driver.| Column | Supported Operators |
| id | =, !=, IN, NOT IN |
| createdAt | =, !=, IN, NOT IN, <, <=, >, >= |
| updatedAt | =, !=, IN, NOT IN, <, <=, >, >= |
| title | =, !=, IN, NOT IN, LIKE, CONTAINS |
| subtitle | =, !=, IN, NOT IN, IS, IS NOT, LIKE, CONTAINS |
| url | =, !=, IN, NOT IN, LIKE, CONTAINS |
| creatorId | =, !=, IN, NOT IN, IS, IS NOT |
| sourceType | =, !=, IN, NOT IN, LIKE, CONTAINS |
For example, the following queries are processed server-side:
SELECT * FROM Attachment LIMIT 1
SELECT * FROM Attachment WHERE createdAt = '2026-01-01T00:00:00Z' LIMIT 1
INSERT
To insert an Attachment record:INSERT INTO Attachment (title, url, issueId) VALUES ('my-attachment', 'attachment-url', '27cab3b0-a2f8-4f82-8b20-7772658f5897')
UPDATE
To update an Attachment record:UPDATE Attachment SET title = 'updated-attachment' WHERE id = '27cab3b0-a2f8-4f82-8b20-7772658f5897'
DELETE
To delete an Attachment record:DELETE FROM Attachment WHERE id = '27cab3b0-a2f8-4f82-8b20-7772658f5897'
Columns
| Name | Type | ReadOnly | Description |
| id [KEY] | String | False |
The unique identifier of the entity. |
| createdAt | Datetime | True |
The time at which the entity was created. |
| updatedAt | Datetime | True |
The last time at which the entity was meaningfully updated. This is the same as the creation time if the entity hasn't been updated after creation. |
| archivedAt | Datetime | True |
The time at which the entity was archived. Null if the entity has not been archived. |
| title | String | False |
Content for the title line in the Linear attachment widget. |
| subtitle | String | False |
Content for the subtitle line in the Linear attachment widget. |
| url | String | False |
The URL of the external resource this attachment links to. Also serves as a unique identifier for the attachment within an issue; no two attachments on the same issue can share the same URL. |
| creatorId | String | True |
The creator of the attachment. |
| externalUserCreatorId | String | True |
The non-Linear user who created the attachment. |
| metadata | String | False |
Integration-specific metadata for this attachment. The schema varies by source type and may include fields such as pull request status, review counts, commit information, ticket status, or other data from the external system. |
| source | String | True |
Information about the source which created the attachment. |
| sourceType | String | True |
The source type of the attachment, derived from the source metadata. Returns the integration type (e.g., 'github', 'slack', 'zendesk') or 'unknown' if no source is set. |
| groupBySource | Bool | False |
Whether attachments from the same source application should be visually grouped together in the Linear issue detail view. |
| originalIssueId | String | True |
The issue this attachment was originally created on. Null if the attachment hasn't been moved. |
| issueId | String | False |
The issue this attachment belongs to. |
| bodyData | String | True |
The body data of the attachment, if any. |