Productmind API

Attachments

Attachments are the files on your records, such as screenshots and documents on a task, a bug report, a session or a note. List a record's attachments with a download link for each, upload a file by requesting an upload link and sending the file to it, edit an attachment's description, and delete it.


List attachments on an entity

GET
https://api.productmind.ai
/workspaces/{workspaceId}/attachments

Returns the file attachments scoped to a parent entity. Each item includes a freshly-issued presigned download URL.

List attachments on an entity › path Parameters

workspaceId
​string · required

Workspace UUID

List attachments on an entity › query Parameters

entity
​string · enum · required

Parent entity type

Enum values:
feature
task
feature_request
bug_report
session
customer_research
customer_interaction
release
entityId
​string · required

Parent entity UUID

page
​number

Page number (1-indexed, default 1)

limit
​number

Items per page (default 50)

search
​string

Full-text search across searchable fields

List attachments on an entity › Responses

200

List of attachments

​PolymorphicAttachmentDTO[] · required

Request a presigned upload URL for an attachment on any entity

POST
https://api.productmind.ai
/workspaces/{workspaceId}/attachments/request-upload

Polymorphic attachment upload. Pass entity (one of the values the request schema lists) and entityId to attach the file to its parent, and a contentType the schema lists. Creates the attachment row and returns a presigned URL the client uses to PUT the bytes. A file may be up to 10 MB, or 100 MB for a video. Optional description annotates why the file was added.

Request a presigned upload URL for an attachment on any entity › path Parameters

workspaceId
​string · required

Workspace UUID

Request a presigned upload URL for an attachment on any entity › Request Body

entity
​string · enum · required
Enum values:
feature
task
feature_request
bug_report
session
customer_research
customer_interaction
release
entityId
​string · minLength: 1 · required
fileName
​string · minLength: 1 · required
contentType
​string · enum · required
Enum values:
image/jpeg
image/png
image/gif
image/webp
image/svg+xml
application/pdf
application/msword
application/vnd.openxmlformats-officedocument.wordprocessingml.document
fileSize
​number · required
description
​string · maxLength: 1000

Request a presigned upload URL for an attachment on any entity › Responses

200

Presigned upload URL and attachment metadata

​object · required

Delete an attachment

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/attachments/{attachmentId}

Removes both the DB row and the underlying S3 object (best-effort).

Delete an attachment › path Parameters

workspaceId
​string · required

Workspace UUID

attachmentId
​string · required

Attachment UUID

Delete an attachment › Responses

200

Attachment deleted

No data returned

Update an attachment

PATCH
https://api.productmind.ai
/workspaces/{workspaceId}/attachments/{attachmentId}

Currently only description is editable. Pass null to clear.

Update an attachment › path Parameters

workspaceId
​string · required

Workspace UUID

attachmentId
​string · required

Attachment UUID

Update an attachment › Request Body

​required

New description for the attachment. Pass null to clear it.

Update an attachment › Responses

200

Updated attachment

​PolymorphicAttachmentDTO · required