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
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.
path Parameters
workspaceIdWorkspace UUID
List agent contexts for a workspace › Responses
List of agent contexts
Create an agent context
Admin creates a new agent context row for the workspace.
path Parameters
workspaceIdWorkspace UUID
Create an agent context › Request Body
titletypesortOrderCreate an agent context › Responses
Created agent context
Generate + save agent context from product 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.
path Parameters
workspaceIdWorkspace UUID
Generate + save agent context from product overview › Responses
Saved agent context
Get an agent context by ID
Returns a single agent context row.
path Parameters
workspaceIdWorkspace UUID
idAgentContext UUID
Get an agent context by ID › Responses
Agent context
Update an agent context
Admin edits title, description, content, or sort order.
path Parameters
workspaceIdWorkspace UUID
idAgentContext UUID
Update an agent context › Request Body
typetitlesortOrderUpdate an agent context › Responses
Updated agent context
List agent skills for a workspace
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.
path Parameters
workspaceIdWorkspace UUID
query Parameters
agentIdOnly return workspace-wide skills plus those for this agent
resolvePlaceholdersSet 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.
List agent skills for a workspace › Responses
List of agent skills
Get an agent skill by 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.
path Parameters
workspaceIdWorkspace UUID
nameSkill name (or UUID)
Get an agent skill by name › Responses
Agent skill