Overview

Allows you to manage file attachments associated with work items and Intake work items. You can upload new attachments and retrieve existing attachments for a specific work item.

Learn more about Attachments →

Deprecation notice

We are deprecating all /api/v1/.../issues/ endpoints in favor of /api/v1/.../work-items/.

End of support
31st March 2026

What you need to do
To ensure uninterrupted service, replace all /issues/ references with /work-items/ in your codebase before the support end date.

Upload process

1. Get the upload credentials.
2. Upload the file to storage.
3. Complete attachment upload to notify server.

The Attachment object

Attributes

• id string

  Unique identifier for the attachment

• created_at , updated_at, deleted_at timestamp

  Timestamp when the attachment was created, when it was last modified or deleted

• attributes object

  Contains file metadata:

  • name string

  Original filename of the attachment

  • size integer

  File size in bytes

  • type string

  MIME type of the file

• asset string

  Storage path/identifier for the attachment file

• entity_type string

  Always ISSUE_ATTACHMENT for work item attachments

• entity_identifier string

  Entity identifier for the attachment

• is_deleted boolean

  Whether the attachment has been deleted

• is_archived boolean

  Whether the attachment has been archived

• external_id string or null

  External identifier if the issue and its attachments are imported to Plane

• external_source string or null

  Name of the source if the issue and its attachments are imported to Plane

• size integer

  File size in bytes

• is_uploaded boolean

  Whether the file has been successfully uploaded

• storage_metadata object

  Cloud storage metadata:

  • ETag string

  Storage provider’s entity tag

  • Metadata object

  Additional storage metadata

  • ContentType object

  MIME type of stored file

  • LastModified timestamp

  Last modification time in storage

  • ContentLength integer

  File size in bytes

• created_by string

  ID of user who created the attachment

• updated_by string

  ID of user who last modified the attachment

• deleted_by string

  ID of user who deleted the attachment

• workspace string

  ID of workspace containing the attachment

• project string

  ID of project containing the work item

• issue string

  ID of work item containing the attachment

• user string

  ID of user associated with the attachment

• draft_issue string

  ID of draft work item if applicable

• comment string

  ID of comment if attachment is associated with a comment

• page string

  ID of page if attachment is associated with a page

THE ATTACHMENT OBJECT

{
    "id": "8caf3ed5-4f57-9674-76c4fce146b2",
    "created_at": "2024-10-30T09:32:32.815273Z",
    "updated_at": "2024-10-30T09:32:35.533136Z",
    "deleted_at": null,
    "attributes": {
        "name": "plane-logo.png",
        "size": 135686,
        "type": "image/png"
    },
    "asset": "9b8aab8a-9052-fc735350abe8/6893d862ecb740d4b7f9f6542cda539c-plane.png",
    "entity_type": "ISSUE_ATTACHMENT",
    "is_deleted": false,
    "is_archived": false,
    "external_id": null,
    "external_source": null,
    "size": 135686.0,
    "is_uploaded": true,
    "storage_metadata": {
        "ETag": "\"72d0d4be99999fe60c2fbc08c8b\"",
        "Metadata": {},
        "ContentType": "image/png",
        "LastModified": "2024-10-30T09:32:34+00:00",
        "ContentLength": 135686
    },
    "created_by": "575de6bf-e120-43bb-9f6a-eae276210575",
    "updated_by": "575de6bf-e120-43bb-9f6a-eae276210575",
    "workspace": "9b8aab8a-9s6a-99ac-fc735350abe8",
    "project": "1790bd-5262-42fb-ac55-568c19a5",
    "issue": "7ba090-7702-4e26-a61e-aa6b866f7",
    }