> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# Objects

> Every object and enum the Attachments tools accept.

## Model tree

<div className="model-tree"><div className="model-tree-scroll"><div className="tree-node"><a href="#attachmentslistvariables">AttachmentsListVariables</a><div className="tree-children"><div className="tree-node"><a href="#attachmentfilter">AttachmentFilter</a><div className="tree-children"><div className="tree-node"><a href="#attachmentfilter">AttachmentFilter</a> <span className="tree-note">above</span></div></div></div></div></div><div className="tree-node"><a href="#attachmentgetvariables">AttachmentGetVariables</a></div><div className="tree-node"><a href="#attachmentsforurlvariables">AttachmentsForUrlVariables</a></div><div className="tree-node"><a href="#attachmentcreatevariables">AttachmentCreateVariables</a><div className="tree-children"><div className="tree-node"><a href="#attachmentcreateinput">AttachmentCreateInput</a></div></div></div><div className="tree-node"><a href="#attachmentupdatevariables">AttachmentUpdateVariables</a><div className="tree-children"><div className="tree-node"><a href="#attachmentupdateinput">AttachmentUpdateInput</a></div></div></div><div className="tree-node"><a href="#attachmentdeletevariables">AttachmentDeleteVariables</a></div></div></div>

## AttachmentsListVariables

Variables for the `attachments` connection.

<div className="reference-table">
  | Field             | Type                                                                           | Description                                                                                                                       |
  | ----------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
  | `first`           | `integer`                                                                      | How many results to return. Linear returns 50 by default. <span className="field-constraints">≥ 1; ≤ 250; defaults to `50`</span> |
  | `after`           | `string`                                                                       | The `endCursor` from the previous page's `pageInfo`, to fetch the next page.                                                      |
  | `filter`          | [AttachmentFilter](#attachmentfilter)                                          | Narrow the attachments returned.                                                                                                  |
  | `includeArchived` | `boolean`                                                                      | Include attachments on archived issues.                                                                                           |
  | `orderBy`         | [PaginationOrderBy](/charter/charter/packs/linear/workspace/objects#paginationorderby) | Sort by 'createdAt' or 'updatedAt'.                                                                                               |
</div>

## AttachmentFilter

A filter over attachments.

<div className="reference-table">
  | Field        | Type                                                                                         | Description                                                                   |
  | ------------ | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
  | `id`         | [IdComparator](/charter/charter/packs/linear/workspace/objects#idcomparator)                         | Filter by attachment UUID.                                                    |
  | `title`      | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Filter by title.                                                              |
  | `subtitle`   | [NullableStringComparator](/charter/charter/packs/linear/workspace/objects#nullablestringcomparator) | Filter by subtitle.                                                           |
  | `url`        | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Filter by the attachment's URL.                                               |
  | `sourceType` | [StringComparator](/charter/charter/packs/linear/workspace/objects#stringcomparator)                 | Filter by which integration created the attachment, e.g. 'github' or 'slack'. |
  | `creator`    | [UserFilter](/charter/charter/packs/linear/workspace/objects#userfilter)                             | Filter by who created the attachment.                                         |
  | `createdAt`  | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                     | Filter by when the attachment was created.                                    |
  | `updatedAt`  | [DateComparator](/charter/charter/packs/linear/workspace/objects#datecomparator)                     | Filter by when the attachment was last updated.                               |
</div>

## AttachmentGetVariables

Variables for the `attachment` query.

<div className="reference-table">
  | Field                                                      | Type     | Description            |
  | ---------------------------------------------------------- | -------- | ---------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The attachment's UUID. |
</div>

## AttachmentsForUrlVariables

Variables for the `attachmentsForURL` query.

<div className="reference-table">
  | Field                                                       | Type      | Description                                                                                                                       |
  | ----------------------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------- |
  | `first`                                                     | `integer` | How many results to return. Linear returns 50 by default. <span className="field-constraints">≥ 1; ≤ 250; defaults to `50`</span> |
  | `after`                                                     | `string`  | The `endCursor` from the previous page's `pageInfo`, to fetch the next page.                                                      |
  | `url` <span className="required" title="required">\*</span> | `string`  | The external URL to look up.                                                                                                      |
</div>

## AttachmentCreateVariables

Variables for the `attachmentCreate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                            | Description               |
  | ------------------------------------------------------------- | ----------------------------------------------- | ------------------------- |
  | `input` <span className="required" title="required">\*</span> | [AttachmentCreateInput](#attachmentcreateinput) | The attachment to create. |
</div>

## AttachmentCreateInput

The input to `attachmentCreate`.

<div className="reference-table">
  | Field                                                           | Type                                     | Description                                                                           |
  | --------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------- |
  | `issueId` <span className="required" title="required">\*</span> | `string`                                 | The issue to associate the attachment with.                                           |
  | `title` <span className="required" title="required">\*</span>   | `string`                                 | The attachment title.                                                                 |
  | `url` <span className="required" title="required">\*</span>     | `string`                                 | The attachment URL.                                                                   |
  | `subtitle`                                                      | `string`                                 | The attachment subtitle.                                                              |
  | `iconUrl`                                                       | `string`                                 | An icon to display with the attachment.                                               |
  | `commentBody`                                                   | `string`                                 | Create a comment with the given markdown body alongside the attachment.               |
  | `groupBySource`                                                 | `boolean`                                | Whether to group attachments from the same source.                                    |
  | `metadata`                                                      | map of `string` \| `integer` \| `number` | Attachment metadata object with string and number values.                             |
  | `id`                                                            | `string`                                 | The identifier in UUID v4 format. If none is provided, the backend will generate one. |
</div>

## AttachmentUpdateVariables

Variables for the `attachmentUpdate` mutation.

<div className="reference-table">
  | Field                                                         | Type                                            | Description            |
  | ------------------------------------------------------------- | ----------------------------------------------- | ---------------------- |
  | `id` <span className="required" title="required">\*</span>    | `string`                                        | The attachment's UUID. |
  | `input` <span className="required" title="required">\*</span> | [AttachmentUpdateInput](#attachmentupdateinput) | The fields to change.  |
</div>

## AttachmentUpdateInput

The fields `attachmentUpdate` changes.

<div className="reference-table">
  | Field                                                         | Type                                     | Description                                               |
  | ------------------------------------------------------------- | ---------------------------------------- | --------------------------------------------------------- |
  | `title` <span className="required" title="required">\*</span> | `string`                                 | The attachment title.                                     |
  | `subtitle`                                                    | `string`                                 | The attachment subtitle.                                  |
  | `iconUrl`                                                     | `string`                                 | An icon to display with the attachment.                   |
  | `metadata`                                                    | map of `string` \| `integer` \| `number` | Attachment metadata object with string and number values. |
</div>

## AttachmentDeleteVariables

Variables for the `attachmentDelete` mutation.

<div className="reference-table">
  | Field                                                      | Type     | Description            |
  | ---------------------------------------------------------- | -------- | ---------------------- |
  | `id` <span className="required" title="required">\*</span> | `string` | The attachment's UUID. |
</div>