Overview

GET    /api/v1/workspaces/:workspace-slug/projects/:project_id/issues/:issue_id/issue-attachments/
POST   /api/v1/workspaces/:workspace-slug/projects/:project_id/issues/:issue_id/issue-attachments/
PATCH  /api/v1/workspaces/:workspace-slug/projects/:project_id/issues/:issue_id/issue-attachments/asset-id/

​

Upload Process

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

​

Issue attachment object

• 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 issue attachments
• 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 issue
• issue string ID of issue containing the attachment

{
    "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",
    }