Productmind API

A decision records what your team decided about a feature request or a feature, and why: the outcome (approved, rejected, deferred or conditional), the rationale and the interests it cites. List the decisions on a feature request or a feature, newest first, or record a new one. Decisions are never edited: a new decision can supersede an earlier one. See Decision records.


List decisions on an entity

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

Returns all decisions for a feature request or feature, ordered by decidedAt descending. Decisions are immutable records of organisational choices with outcome, rationale, and cited interests.

List decisions on an entity › path Parameters

workspaceId
​string · required

Workspace UUID

List decisions on an entity › query Parameters

entity
​string · enum · required

Parent entity type

Enum values:
feature_request
feature
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 decisions on an entity › Responses

200

List of decisions

​DecisionDTO[] · required
​object
​object

Record a decision on a feature request or feature

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

Creates an immutable decision record with outcome (approved/rejected/deferred/conditional), rationale, decider info, and optional cited interests. Decisions can supersede prior decisions via supersedesId.

Record a decision on a feature request or feature › path Parameters

workspaceId
​string · required

Workspace UUID

Record a decision on a feature request or feature › Request Body

entity
​string · enum · required
Enum values:
feature_request
feature
entityId
​string · minLength: 1 · required
decisionType
​string · enum · required
Enum values:
transition
general
outcome
​string · enum · required
Enum values:
approved
rejected
deferred
conditional
title
​string
rationale
​string
conditionalNotes
​string
decidedByUserId
​string
decidedByName
​string
supersedesId
​string
citedInterestIds
​string[]

Record a decision on a feature request or feature › Responses

Decision created

​DecisionDTO · required