Productmind API

Feature requests

Feature requests collect what customers and your team ask for, with the evidence of who wants each one. Create, update and search requests, record interests and link the customer interactions behind them, and merge duplicates. When you decide to build one, promote it into a feature or a task. See Feature requests.


List feature requests in a workspace

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests

Returns feature requests — user-submitted ideas and demands that may become product features. Includes interest counts, tags, status, and the Applications/Features each request is linked to. Filterable by status, priority, source, application, feature, and tags. Returns: id, title, description, priority, status, interestCount, tags, relationships, linkedEntity (the Feature or Task a promoted request became, or the request a merged one was folded into), createdAt.

List feature requests in a workspace › path Parameters

workspaceId
​string · required

Workspace UUID

List feature requests 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:
title
priority
status
source
createdAt
updatedAt
relevance
sortOrder
​string · enum

Sort direction (default desc)

Enum values:
asc
desc
search
​string

Full-text search across searchable fields

priority
​

Filter by priority (single value or array)

status
​

Filter by status (single value or array)

source
​

Filter by source (single value or array)

application
​string

Filter by linked application id

feature
​string

Filter by linked feature id

tags
​

Filter by tag names (single value or comma-separated array)

account
​

Filter by requesting account ids (single value or comma-separated array), matched through feature-request interests

assigneeId
​string

Filter by assignee: a user or team UUID, or a comma-separated list of them (requests assigned to ANY listed user/team match). my-teams stands for every team the caller belongs to.

activityAfter
​string · date-time · pattern: ^(?:(?:\d\d[2468][04…

Only the items with activity after this ISO 8601 instant (for example 2026-10-26T09:00:00Z): for a session its last activity, or its last update when it has none; for every other list its last update (updatedAt). Send it with limit=1 and read pagination.total to count what changed since then. The response names the instant it applied in filters.activityAfter. A value that is not an ISO 8601 instant is refused with 400.

includeSessions
​string · enum

Opt in to each request's sessions: the coding sessions of the task it was promoted to (id, displayId, name, category, status), scans and code chats left out; empty for a request not promoted to a task. Returned only to a caller who may read coding sessions. Defaults to false.

Enum values:
true
false

List feature requests in a workspace › Responses

200

List of feature requests

​FeatureRequestDTO[] · required
​object
​object

Create a feature request

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests

Submit a new feature request to capture user demand. Requests start in 'new' status and can be moved to in_review, then promoted, merged, or rejected. When a specific customer or teammate asked for it, pass them in interests (a customer is their contact id from list-contacts): that records who wants it, counts toward its interest count and files it under the customer's account, while a name written into the description counts nothing. Every entry is checked before anything is written, so one that cannot be recorded (an unknown contact) rejects the whole call and creates nothing. Recording interests needs permission to update feature requests as well as to create them. To add interest to a request that already exists, use add-feature-request-interest.

Create a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

Create a feature request › Request Body

title
​string · minLength: 1 · required
description
​string · minLength: 1 · required

Markdown, at most 200,000 characters.

source
​string · enum · required

What KIND of request this is, e.g. customer_feedback for something customers ask for. It does not record WHO asked: pass the people in interests.

Enum values:
internal_stakeholders
customer_feedback
market_signal
strategic_directive
support_pattern
competitive_intelligence
priority
​string · enum
Enum values:
low
high
critical
estimatedEffort
​string · enum
Enum values:
__none__
xs
s
m
l
xl
sortOrder
​number
​CreateManualInterestBody[] · maxItems: 20

Optional. Who asked for this request, recorded as interest in the same call: each entry is exactly the body add-feature-request-interest takes. A customer is { requestingContactId } (find the contact with list-contacts, or add someone not on file yet with create-contact; their account comes with them). This is what counts the demand on the request and files it under the customer's account: a name written into the description counts nothing. Every entry is checked before anything is written, so an unknown contact rejects the whole call and creates nothing. Needs permission to update feature requests. At most 20.

Create a feature request › Responses

Created feature request

​FeatureRequestDTO · required

Update feature request status

PATCH
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/status

Transition a feature request between statuses: new, in_review, promoted, merged, rejected.

Update feature request status › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Update feature request status › Request Body

status
​string · enum · required
Enum values:
new
in_review
rejected
merged
promoted

Update feature request status › Responses

200

Feature request status updated

No data returned

Merge feature requests into a target

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/merge

Merge one or more source feature requests into a target feature request. Copies interests from sources to target, creates MERGED_WITH relationships, sets source statuses to 'merged', and uses an LLM to synthesize an updated description for the target.

Merge feature requests into a target › path Parameters

workspaceId
​string · required

Workspace UUID

Merge feature requests into a target › Request Body

sourceIds
​string[] · minItems: 1 · required
targetId
​string · minLength: 1 · required

Merge feature requests into a target › Responses

200

Merge result with updated target and description status

​object · required

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/search

Semantic search over feature-request titles using the knowledge base (LanceDB). Handles paraphrases that keyword search would miss. Every hit is matchType: "semantic" with an absolute similarity score (comparable across queries). Returns a lean shape (id + title + score + matchType) — follow up with get-feature-request for full details. Hits below the server-side noise floor are filtered, so an empty list means no real match. Prefer list-feature-requests for structured filtering (status / source / priority).

Find a feature request by topic (semantic search) › path Parameters

workspaceId
​string · required

Workspace UUID

Find a feature request by topic (semantic search) › query Parameters

q
​string · required

Search query

limit
​integer · min: 1 · max: 50

Max results (default 10, cap 50)

Find a feature request by topic (semantic search) › Responses

200

Ranked feature-request matches with relevance scores

​FeatureRequestSearchResult[] · required

Bulk promote feature requests to a feature

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/promote

Promote multiple feature requests to the same feature. Sets their status to 'promoted' and creates PROMOTED_TO entity relationships. Every request must be in 'new' or 'in_review' status: if any is not, the call returns 409 naming each one, and nothing is promoted.

Bulk promote feature requests to a feature › path Parameters

workspaceId
​string · required

Workspace UUID

Bulk promote feature requests to a feature › Request Body

ids
​string[] · minItems: 1 · required
featureId
​string · minLength: 1 · required

Bulk promote feature requests to a feature › Responses

Promoted feature requests

​FeatureRequestDTO[] · required

Promote a feature request to a feature

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/promote

Promote a single feature request to a feature. Sets the request status to 'promoted' and creates a PROMOTED_TO entity relationship. Only a request in 'new' or 'in_review' status can be promoted: a 'merged', 'rejected' or already 'promoted' request returns 409. To promote a rejected request, set it back to 'in_review' first; to promote the demand of a merged request, promote the request it was merged into.

Promote a feature request to a feature › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Promote a feature request to a feature › Request Body

featureId
​string · minLength: 1 · required

Promote a feature request to a feature › Responses

Promoted feature request

​FeatureRequestDTO · required

Bulk promote feature requests to tasks

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/promote-to-task

Promote multiple feature requests into one task each, optionally all under the same parent feature. Every task inherits its own request's title, description and priority. Sets each request's status to 'promoted' and creates a PROMOTED_TO entity relationship to its task. Every request must be in 'new' or 'in_review' status: if any is not, the call returns 409 naming each one, and no task is created.

Bulk promote feature requests to tasks › path Parameters

workspaceId
​string · required

Workspace UUID

Bulk promote feature requests to tasks › Request Body

ids
​string[] · minItems: 1 · required

Feature request UUIDs

featureId
​string

Optional parent Feature UUID applied to every created task.

Bulk promote feature requests to tasks › Responses

The created tasks paired with their promoted feature requests

​object[] · required

Promote a feature request to a task

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/promote-to-task

Promote a single feature request into a Task - use this when the request is a piece of work inside a feature that already exists, rather than a capability of its own (for that, use promote-feature-request). The task inherits the request's title, description and priority unless overridden, and may be parented to a feature. Sets the request's status to 'promoted' and creates a PROMOTED_TO entity relationship. A request can be promoted only once, to a feature OR a task, and only from 'new' or 'in_review' status: a 'merged', 'rejected' or already 'promoted' request returns 409, and no task is created. To promote a rejected request, set it back to 'in_review' first; to promote the demand of a merged request, promote the request it was merged into.

Promote a feature request to a task › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Promote a feature request to a task › Request Body

title
​string

Task title. Defaults to the feature request's title.

description
​string

Task description, markdown. Defaults to the feature request's description.

featureId
​string

Optional parent Feature UUID. Omit to create a workspace-level task with no feature.

Promote a feature request to a task › Responses

The created task and the promoted feature request

​object · required

Get interest source summary for a feature request

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/source-summary

Returns an aggregated summary of all interest sources for a feature request — showing where demand is coming from (manual entries, customer interactions, etc.).

Get interest source summary for a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Get interest source summary for a feature request › Responses

200

Source summary


List interests for a feature request

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/interests

Who wants a feature request: every interest recorded on it, newest first. Each carries its source (a customer, a teammate, or other input such as a market signal), the customer's contact and account, the teammate's role and name, the sentiment, the position and what they said. Interests that were removed are not listed. Check this before recording an interest, so the same person's ask is not recorded twice.

List interests for a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

List interests for a feature request › Responses

200

List of interests

​FeatureRequestInterestDTO[] · required

Add manual interest to a feature request

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/interests

Record who wants a feature request, such as a customer mentioning it in a call or email. Three kinds: a customer (requestingContactId, their contact id from list-contacts; the contact's account is attached with them), a teammate (stakeholderRole, plus stakeholderUserId or stakeholderName), or other input (source set to competitive_intelligence, market_signal, strategic_directive or support_pattern, with a description; no contact). Each call adds one interest: check list-feature-request-interests first, because calling twice records the same ask twice. When the ask came from a customer meeting or conversation already recorded in the workspace, use link-interaction-interest instead.

Add manual interest to a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Add manual interest to a feature request › Request Body

source
​string · enum

Who this interest speaks for. Defaults to customer_feedback, which needs requestingContactId. internal_stakeholders is a teammate (set stakeholderRole). competitive_intelligence, market_signal, strategic_directive and support_pattern are other input: no contact, and you are recorded as who added it. Ignored when stakeholderRole is set.

Enum values:
internal_stakeholders
customer_feedback
market_signal
strategic_directive
support_pattern
competitive_intelligence
description
​string · maxLength: 2000

What they want or said, in their words where you have them, e.g. "Needs SSO before the Q3 rollout."

sentiment
​string · enum

How the person feels about the request, when known.

Enum values:
negative
neutral
positive
requestingContactId
​string

The UUID of the customer contact who asked (find it with list-contacts; each row's id is this value). Someone who is not on file yet is added with create-contact, whose id is this value too. Required for a customer interest. The contact's account is attached automatically, so there is no account field. A contact outside this workspace's organization is rejected.

position
​string · enum

Their stance: supporting, neutral, opposing, or conditional (then say the condition in conditionalNotes). Mostly for teammates and other input.

Enum values:
supporting
opposing
neutral
conditional
conditionalNotes
​string · maxLength: 2000

The condition behind a conditional position, e.g. "Only if it ships with SSO."

stakeholderRole
​string · enum

Set this to record a TEAMMATE's interest instead of a customer's: the interest becomes internal_stakeholders, whatever source says. Name the teammate with stakeholderUserId or stakeholderName; with neither, it is recorded as yours.

Enum values:
marketing
leadership
engineering
design
sales
customer_support
customer_engineering
finance
stakeholderUserId
​string

The workspace member the teammate interest is from (a user UUID). Takes precedence over stakeholderName.

stakeholderName
​string · maxLength: 200

The teammate's name as free text, for someone who is not a workspace member.

weight
​number

Optional relative weight of this interest. Leave it unset unless the user gives one.

Add manual interest to a feature request › Responses

Interest added

​FeatureRequestInterestDTO · required

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/interests/from-interaction

Record a customer meeting or conversation the workspace already holds as interest in a feature request. The interaction's contact, account, sentiment and summary are copied onto the interest, and it links back to the conversation. Find the interaction with list-customer-interactions. Linking the same interaction twice records it twice.

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

interactionId
​string · minLength: 1 · required

The UUID of the customer meeting or conversation to record as interest (find it with list-customer-interactions). Its contact, account, sentiment and summary are copied onto the interest.

Interest created from interaction

​FeatureRequestInterestDTO · required

List feature requests linked to a customer interaction

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/by-interaction/{interactionId}

Returns feature requests that have interests sourced from the specified customer interaction.

List feature requests linked to a customer interaction › path Parameters

workspaceId
​string · required

Workspace UUID

interactionId
​string · required

Customer interaction UUID

List feature requests linked to a customer interaction › Responses

200

List of linked feature requests

​FeatureRequestDTO[] · required

Remove an interest from a feature request

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/interests/{interestId}

Delete a specific interest entry from a feature request.

Remove an interest from a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

interestId
​string · required

Interest UUID to remove

Remove an interest from a feature request › Responses

200

Interest removed

No data returned

Update an interest on a feature request

PATCH
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/interests/{interestId}

Edit a stakeholder input, competitive intelligence note, or customer interest. Only the original contributor — or a caller holding the member:update capability — may edit stakeholder-attributed rows.

Update an interest on a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

interestId
​string · required

Interest UUID to update

Update an interest on a feature request › Request Body

description
​string · maxLength: 2000
sentiment
​string · enum
Enum values:
negative
neutral
positive
position
​string · enum
Enum values:
supporting
opposing
neutral
conditional
conditionalNotes
​string · maxLength: 2000
weight
​number

Update an interest on a feature request › Responses

200

Updated interest

​FeatureRequestInterestDTO · required

List logs on a feature request

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/logs

Returns log entries for a feature request, newest first.

List logs on a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

List logs on a feature request › Responses

200

List of logs

​FeatureRequestLogDTO[] · required
​object
​object

Add a log entry to a feature request

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/logs

Post a new log entry on a feature request.

Add a log entry to a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Add a log entry to a feature request › Request Body

content
​string · minLength: 1 · required

Add a log entry to a feature request › Responses

Log added

​FeatureRequestLogDTO · required

Delete a log entry from a feature request

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/logs/{logId}

Remove a log entry from a feature request.

Delete a log entry from a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

logId
​string · required

Log UUID

Delete a log entry from a feature request › Responses

200

Log deleted

No data returned

Update a log entry on a feature request

PATCH
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/logs/{logId}

Edit your own log entry on a feature request.

Update a log entry on a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

logId
​string · required

Log UUID

Update a log entry on a feature request › Request Body

content
​string · minLength: 1 · required

Update a log entry on a feature request › Responses

200

Log updated

No data returned

List merged source requests

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/merged

Returns feature requests that were merged into this target request via MERGED_WITH relationships.

List merged source requests › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Target feature request UUID

List merged source requests › Responses

200

List of merged source requests

​FeatureRequestDTO[] · required

List a feature request's relationships

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/relationships

Returns the Applications and Features linked to a feature request. Only hand-made related_to links — the promoted_to / merged_with rows the promote and merge flows write are reported by the request's linkedEntity instead.

List a feature request's relationships › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

List a feature request's relationships › Responses

200

List of relationships

​FeatureRequestRelationshipDTO[] · required

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/relationships

Create a relationship between a feature request and an Application (where the demand applies) or a Feature (the affected area).

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

targetType
​string · enum · required
Enum values:
application
feature
targetId
​string · minLength: 1 · required
relationshipType
​string

Created relationship

​FeatureRequestRelationshipDTO · required

Remove a feature request relationship

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/relationships/{relationshipId}

Delete a link between a feature request and an application or feature.

Remove a feature request relationship › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

relationshipId
​string · required

Relationship UUID

Remove a feature request relationship › Responses

200

Relationship removed

No data returned

Get a feature request by ID

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}

Retrieve a single feature request: its title, description, status, priority and source, its tags, the applications and features it is linked to, what it became (the feature or task it was promoted to, or the request it was merged into), the note or bug report it was created from, and its assignees. It does not include who wants it: read that with list-feature-request-interests.

Get a feature request by ID › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Get a feature request by ID › Responses

200

Feature request details

​FeatureRequestDTO · required

Update a feature request

PUT
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}

Modify feature request title, description, or priority.

Update a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Update a feature request › Request Body

title
​string
description
​string

Markdown, at most 200,000 characters. Replaces the whole description: send it only with the complete new text. To change part of the description, send descriptionEdits instead.

​object[] · minItems: 1 · maxItems: 50

Change PART of the description without resending it: a list of exact find-and-replace edits the server applies to the stored description, in order, all or none. Each find must be copied exactly (same characters, spacing and line breaks) from the description as it stands, and must occur exactly once there at that point: include enough surrounding text to make it unique. replace is the new text (an empty string deletes the passage). Everything outside the passages is kept as it is. Prefer this over description for any change to a long description, and always when your read of the description was cut. Cannot be sent together with description.

priority
​string · enum
Enum values:
low
high
critical
status
​string · enum
Enum values:
new
in_review
rejected
merged
promoted
​
sortOrder
​number
​

Set the single USER assignee (legacy-shaped field): replaces the request's user assignees with this one, null unassigns every user. Team assignees are left untouched — use assignees to change them.

​AssignmentTargetInput[] · maxItems: 20

REPLACES the item's whole assignee set: every user and team listed becomes an assignee, everything not listed is unassigned. Pass [] to unassign everyone. When both this and the legacy single-user field (assigneeId / ownerId) are supplied, this wins. Find a team's id with list-teams and a person's with list-assignable-users.

Update a feature request › Responses

200

Updated feature request

No data returned

Delete a feature request

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}

Permanently remove a feature request.

Delete a feature request › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Delete a feature request › Responses

200

Feature request deleted

No data returned

Describe a feature request from its screenshots

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/describe-from-images

Trigger the vision agent to read the feature request's attached screenshots and draft an updated description, incorporating the existing description and the interest recorded against the request. Idempotent while a run is in flight. On a blank description the draft is applied automatically; otherwise it is held for review.

Describe a feature request from its screenshots › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

Describe a feature request from its screenshots › Request Body

source
​string · enum

How the run was triggered (auto on image upload / manual button)

Enum values:
auto
manual

Describe a feature request from its screenshots › Responses

The queued (or in-flight) description proposal


List a feature request's description proposals

GET
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/description-proposal

Returns AI-drafted description proposals for a feature request. Pass activeOnly=true for the single in-flight / awaiting-review proposal.

List a feature request's description proposals › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

List a feature request's description proposals › query Parameters

activeOnly
​boolean

List a feature request's description proposals › Responses

200

Description proposals


Apply a feature request description proposal

POST
https://api.productmind.ai
/workspaces/{workspaceId}/feature-requests/{id}/description-proposal/{proposalId}/apply

Write the reviewer-composed markdown (accepted diff blocks) to the feature request's description and settle the proposal.

Apply a feature request description proposal › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Feature request UUID

proposalId
​string · required

Proposal UUID

Apply a feature request description proposal › Request Body

description
​string · minLength: 1 · maxLength: 200000 · required

Apply a feature request description proposal › Responses

200

The applied proposal

No data returned