Productmind API

Architecture map

The architecture map shows which of your services depend on which, including across repositories, and the databases, queues, caches and third-party APIs they use. Read the map, map your service architecture from your applications or from repositories that aren't applications yet, and follow the scan's progress or stop it. Productmind creates an application for each scanned repository that isn't one yet. See Applications.


Get the workspace's service dependency map

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

Returns every node in the architecture graph (applications plus the databases, queues, caches, third-party APIs and monorepo sub-services they depend on) and the connects_to edges between them. Edges whose endpoints no longer exist are filtered out.

Get the workspace's service dependency map › path Parameters

workspaceId
​string · required

Get the workspace's service dependency map › Responses

200

The architecture graph

​ArchitectureGraphDTO · required

List the features a service implements

GET
https://api.productmind.ai
/workspaces/{workspaceId}/architecture/components/{componentId}/features

Returns the features linked to one service of a monorepo application: those whose recorded code paths sit inside the service's folder, and those a person added to it by hand, minus any folder match a person hid. Each row says which (source: folder or manual). A map node that is not a service of an application, such as a database or a third-party API, returns an empty list.

List the features a service implements › path Parameters

workspaceId
​string · required

Workspace UUID

componentId
​string · required

The service's id, as on the architecture map

List the features a service implements › Responses

The service's features, by title

​ServiceFeatureDTO[] · required

Get the latest architecture scan run

GET
https://api.productmind.ai
/workspaces/{workspaceId}/architecture/runs/latest

The most recent workspace architecture scan of any status — drives the map's staleness caption and its in-flight progress.

Get the latest architecture scan run › path Parameters

workspaceId
​string · required

Get the latest architecture scan run › Responses

200

The latest run, or null when the workspace has never been mapped

​required

Stop the in-flight architecture scan

POST
https://api.productmind.ai
/workspaces/{workspaceId}/architecture/scan/cancel

Settles the running scan and cancels its background session, which also releases the one-scan-at-a-time slot so a new map can be started immediately. Idempotent — with no scan in flight it returns the latest run untouched. The agent is not stopped synchronously: it learns on its next status poll. Deliberately not MCP-exposed — an agent must not cancel its own run.

Stop the in-flight architecture scan › path Parameters

workspaceId
​string · required

Stop the in-flight architecture scan › Responses

200

The settled run, or null when the workspace has never been mapped

​required

Map (or re-map) the workspace architecture

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

Starts ONE background Productmind agent scan across every selected repository at once - the only way to see a dependency BETWEEN two services, which a per-repository scan structurally cannot. Takes existing applications (applicationIds, to re-map) and/or raw repository refs (repositories, for anything not yet an application); the union is deduped. Creates an application per scanned repository that does not have one, and reconciles the graph against what it finds. On a pay-as-you-go plan it starts only when your balance covers what its run reserves; otherwise it answers 402 (or 429) before anything is created. Needs application:create (Owner, Admin and Power User by default).

Map (or re-map) the workspace architecture › path Parameters

workspaceId
​string · required

Map (or re-map) the workspace architecture › Request Body

applicationIds
​string[] · maxItems: 60
​object[] · maxItems: 60

Map (or re-map) the workspace architecture › Responses

The queued scan run

​WorkspaceScanRunDTO · required