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

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