Productmind API

Cloud accounts

A cloud account is an AWS account a workspace deploys into: one Productmind creates and manages for you, or one you own and connect. List the workspace's cloud accounts and read one: its kind, tier and status, and its AWS account id once known. Reading them needs permission to read cloud accounts, which Owners and Admins have.


List cloud accounts

GET
https://api.productmind.ai
/workspaces/{workspaceId}/cloud-accounts

Lists the AWS accounts the workspace deploys into, newest first: managed accounts Productmind created and accounts the workspace connected, each with its kind, tier, status and AWS account id once known, the application environments that deploy to it (attachments, by ids), whether an environment attached to it can take Productmind's address now (productmindAddress; otherwise it needs a domain the company owns), and since when a managed account is frozen over its spend cap (spendHeldAt; a frozen account takes no new environment). Accounts that were closed, handed over or disconnected are listed too, with live set to false. Needs permission to read cloud accounts, which Owners and Admins have: without it the call answers 403, and retrying will not help.

List cloud accounts › path Parameters

workspaceId
​string · required

Workspace UUID

List cloud accounts › Responses

The workspace's cloud accounts

​CloudAccountDTO[] · required

Get a cloud account

GET
https://api.productmind.ai
/workspaces/{workspaceId}/cloud-accounts/{id}

Returns one of the workspace's AWS accounts: its kind, tier and status, its AWS account id and region once known, why its last step failed, after a deletion when its retention ends, the application environments that deploy to it (attachments, by ids, even once an application is deleted), and since when a managed account is frozen over its spend cap (spendHeldAt; a frozen account takes no new environment). Needs permission to read cloud accounts, which Owners and Admins have: without it the call answers 403, and retrying will not help. 404 when the workspace has no such account.

Get a cloud account › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

The cloud account's id, from list-cloud-accounts

Get a cloud account › Responses

The cloud account

​CloudAccountDTO · required

Get a cloud account's costs

GET
https://api.productmind.ai
/workspaces/{workspaceId}/cloud-accounts/{id}/cost-estimates

Returns what one of the workspace's AWS accounts costs, month by month: the current month as an estimate, refreshed about once a day with the time it was read, and each month AWS has closed as its statement: the amount charged, or to be charged (state and charge say which). Each month is given per day, per service and per application environment, in euros at AWS public on-demand prices (or at what AWS charged where it publishes no price) plus the plan's cloud markup. Spend no application environment owns, such as the account's own network, is listed as unallocated. Every month the account has figures for is listed too, newest first. An account the company connected itself is billed by AWS and has none, and neither has a managed account with no AWS account yet. For a managed account, while it runs, the current month also carries its spend cap (spendCap): the monthly cap, who set its limit, this month's spend against it, and whether the account is frozen over it; an account queued for closure or closed has none. Needs permission to read cloud accounts, which Owners and Admins have: without it the call answers 403, and retrying will not help. 404 when the workspace has no such account.

Get a cloud account's costs › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

The cloud account's id, from list-cloud-accounts

Get a cloud account's costs › query Parameters

month
​string · pattern: ^\d{4}-(0[1-9]|1[0-2…

The month to answer, as YYYY-MM in UTC (2026-10). Defaults to the current month. Months before costs were first recorded, and months after the current one, are refused.

Get a cloud account's costs › Responses

The month's costs and every month with figures

​CloudAccountCostEstimatesDTO · required