Productmind API

Agent context

The agent context is standing background about your product that the PM agent, the interview agent and the generators always read. Skills are named procedures an agent loads when a job calls for one. List, create, update and delete the context and skills, generate the context from your product overview (this replaces the one you have), and fetch a skill by its name. See Agents.


List agent contexts for a workspace

GET
https://api.productmind.ai
/workspaces/{workspaceId}/agent-contexts

Returns the workspace's agent context rows. The type='context' row is the standing briefing the PM agent, the interview agent and some generators read; coding sessions, scans and agent definitions don't read it. type='skill' rows are procedures an agent loads when a job calls for one. Read-only for external clients.

List agent contexts for a workspace › path Parameters

workspaceId
​string · required

Workspace UUID

List agent contexts for a workspace › Responses

200

List of agent contexts

​AgentContextDTO[] · required
​object
​object

Create an agent context

POST
https://api.productmind.ai
/workspaces/{workspaceId}/agent-contexts

Admin creates a new agent context row for the workspace.

Create an agent context › path Parameters

workspaceId
​string · required

Workspace UUID

Create an agent context › Request Body

title
​string · minLength: 1 · required
type
​string · enum
Enum values:
context
skill
Default: context
​
​
​
​
sortOrder
​integer · min: 0 · max: 9007199254740991

Create an agent context › Responses

Created agent context

​AgentContextDTO · required

Generate + save agent context from product overview

POST
https://api.productmind.ai
/workspaces/{workspaceId}/agent-contexts/generate-from-overview

Runs the agent_context_seed generator against the workspace's product overview, upserts the workspace's type='context' row, and returns the saved row. The client should refetch the list to surface the new content.

Generate + save agent context from product overview › path Parameters

workspaceId
​string · required

Workspace UUID

Generate + save agent context from product overview › Responses

200

Saved agent context

​AgentContextDTO · required

Get an agent context by ID

GET
https://api.productmind.ai
/workspaces/{workspaceId}/agent-contexts/{id}

Returns a single agent context row.

Get an agent context by ID › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

AgentContext UUID

Get an agent context by ID › Responses

200

Agent context

​AgentContextDTO · required

Update an agent context

PUT
https://api.productmind.ai
/workspaces/{workspaceId}/agent-contexts/{id}

Admin edits title, description, content, or sort order.

Update an agent context › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

AgentContext UUID

Update an agent context › Request Body

type
​string · enum
Enum values:
context
skill
title
​string · minLength: 1
​
​
​
​
sortOrder
​integer · min: 0 · max: 9007199254740991

Update an agent context › Responses

200

Updated agent context

​AgentContextDTO · required

Delete an agent context

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/agent-contexts/{id}

Removes an agent context row. Agents will no longer receive it in their system prompt.

Delete an agent context › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

AgentContext UUID

Delete an agent context › Responses

200

Deleted

No data returned

List agent skills for a workspace

GET
https://api.productmind.ai
/workspaces/{workspaceId}/agent-skills

Returns the reusable, named skills (agent_context rows with type='skill') available in this workspace. Each skill is a procedure an agent can load on demand by name (e.g. referenced as /skill-name). Optionally filter by agentId to include only workspace-wide skills (agentId=null) plus those targeting that agent.

List agent skills for a workspace › path Parameters

workspaceId
​string · required

Workspace UUID

List agent skills for a workspace › query Parameters

agentId
​string

Only return workspace-wide skills plus those for this agent

resolvePlaceholders
​string · enum

Set to 'true' to expand template placeholders such as {FEATURE_TEMPLATE} in each skill's content. Off by default: the returned content is the raw stored text, which is what an editor must save back.

Enum values:
true
false

List agent skills for a workspace › Responses

200

List of agent skills

​AgentContextDTO[] · required
​object
​object

Get an agent skill by name

GET
https://api.productmind.ai
/workspaces/{workspaceId}/agent-skills/{name}

Resolves a single skill by its name (case-insensitive), falling back to a UUID lookup. Returns the skill's full content so an agent can load the procedure on demand.

Get an agent skill by name › path Parameters

workspaceId
​string · required

Workspace UUID

name
​string · required

Skill name (or UUID)

Get an agent skill by name › Responses

200

Agent skill

​AgentContextDTO · required