Notes
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
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.
path Parameters
workspaceIdWorkspace UUID
query Parameters
pagePage number (1-indexed, default 1)
limitItems per page (default 50)
sortByField to sort by
sortOrderSort direction (default desc)
searchFull-text search across searchable fields
includeArchivedtagsComma-separated tag names to filter by: a note matches when it carries any of them
List notes in a workspace › Responses
List of notes
Create a note
Create a free-form note to capture information, meeting notes, or research findings.
path Parameters
workspaceIdWorkspace UUID
Create a note › Request Body
titlerawContentcontactIdtagspinnedCreate a note › Responses
Created note
Get a note by ID
Retrieve a single note with its full content and AI-generated summary.
path Parameters
workspaceIdWorkspace UUID
idNote UUID
Get a note by ID › Responses
Note details
Update a note
Modify note title or content.
path Parameters
workspaceIdWorkspace UUID
idNote UUID
Update a note › Responses
Updated note
Generate AI summary for a note
Trigger AI-powered summarization of a note's content. The summary is stored on the note and returned.
path Parameters
workspaceIdWorkspace UUID
idNote UUID
Generate AI summary for a note › Responses
Note with generated summary
Convert a note into a backlog item
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.
path Parameters
workspaceIdWorkspace UUID
idNote UUID
Convert a note into a backlog item › Request Body
targetTypeWhat 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.
featureId^([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