Productmind API

Notes are the quick write-ups on your workspace's notes wall: a customer quote, an idea, a reminder. Create, edit, pin and delete notes, have AI summarize one, and convert a note into a feature request, feature, task or bug report. See Notes.


List notes in a workspace

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

Returns notes used to capture free-form information, meeting notes, or research findings within a workspace. Without sortBy, pinned notes come first, then the most recently created. search matches the title, the text and the contact's name. tags (comma-separated) keeps the notes carrying any of those tags. Returns: id, title, content, summary, createdAt, updatedAt.

List notes in a workspace › path Parameters

workspaceId
​string · required

Workspace UUID

List notes in a workspace › query Parameters

page
​number

Page number (1-indexed, default 1)

limit
​number

Items per page (default 50)

sortBy
​string · enum

Field to sort by

Enum values:
createdAt
updatedAt
title
pinned
color
contact
sortOrder
​string · enum

Sort direction (default desc)

Enum values:
asc
desc
search
​string

Full-text search across searchable fields

includeArchived
​boolean
tags
​string

Comma-separated tag names to filter by: a note matches when it carries any of them

List notes in a workspace › Responses

200

List of notes

​NoteDTO[] · required
​object
​object

Create a note

POST
https://api.productmind.ai
/workspaces/{workspaceId}/notes

Create a free-form note to capture information, meeting notes, or research findings.

Create a note › path Parameters

workspaceId
​string · required

Workspace UUID

Create a note › Request Body

title
​string
rawContent
​string
contactId
​string
tags
​string[]
pinned
​boolean
​

Create a note › Responses

Created note

​NoteDTO · required

Get a note by ID

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

Retrieve a single note with its full content and AI-generated summary.

Get a note by ID › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Note UUID

Get a note by ID › Responses

200

Note details

​NoteDTO · required

Update a note

PUT
https://api.productmind.ai
/workspaces/{workspaceId}/notes/{id}

Modify note title or content.

Update a note › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Note UUID

Update a note › Request Body

​
rawContent
​string
​
tags
​string[]
pinned
​boolean
​

Update a note › Responses

200

Updated note

​NoteDTO · required

Delete a note

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/notes/{id}

Permanently remove a note.

Delete a note › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Note UUID

Delete a note › Responses

200

Note deleted

No data returned

Generate AI summary for a note

POST
https://api.productmind.ai
/workspaces/{workspaceId}/notes/{id}/summarize

Trigger AI-powered summarization of a note's content. The summary is stored on the note and returned.

Generate AI summary for a note › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Note UUID

Generate AI summary for a note › Responses

200

Note with generated summary

​NoteDTO · required

Convert a note into a backlog item

POST
https://api.productmind.ai
/workspaces/{workspaceId}/notes/{id}/promote

Convert a note into a Feature Request, Feature, Task or Bug Report. The new entity is pre-filled from the note's title, body, AI summary and labels; the note is archived and linked to the entity in both directions. For a Task, featureId names the feature the task belongs to; omit it for a task with no feature. Idempotent: a second call returns the entity the first one created with created: false.

Convert a note into a backlog item › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Note UUID

Convert a note into a backlog item › Request Body

targetType
​string · enum · required

What to convert this note into. feature_request for a demand signal, feature for a roadmap item, task for engineering follow-up, bug_report for an observed defect. The note is archived on success and the new entity links back to it.

Enum values:
feature_request
feature
task
bug_report
featureId
​string · uuid · pattern: ^([0-9a-fA-F]{8}-[0-…

Task conversions only: the UUID of the feature the new task belongs to, in this workspace. Omit it for a task with no feature. Sending it with any other targetType is a 400. Ignored when the note was already converted: the call returns the item it became.

Convert a note into a backlog item › Responses

The created (or existing) backlog item and the archived note

​PromoteNoteResponse · required