Skip to content
/
List connected accounts
Last updated

List connected cloud accounts

Lists the cloud provider accounts your organization connected for Forge cloud compute, one per offering, with whether each still works (status), when the provider last accepted it and, for tokens that expire, when it will stop working. Use it to show which bring-your-own offerings are ready. The account's secret values are write-only and are never returned, in any form. Requires a bearer token (or API key) whose principal holds the use_forge capability in the acting organization; it works while Forge cloud compute is switched off.

GEThttps://api.aitronos.com/v1/forge/compute/credentials

This endpoint takes no parameters.

Query Parameters

organization_id string optional

The organization to act in. Defaults to your current organization. You must be an active member of it, or the request is refused with 403 ORGANIZATION_ACCESS_DENIED.

Headers

X-Organization-Id string optional

The same as organization_id, as a header. When both are sent, the query parameter wins.

Returns

An array, one entry per connected account, ordered by offering. Empty when nothing is connected.

  • offering_id string — the offering the account connects, e.g. hetzner. One account is stored per offering and organization.
  • set boolean — always true: account details are stored. The values themselves are never returned.
  • account_label string or null — a name the provider reports for the account (project, team or user name), or null when the provider exposes none.
  • verified_at string or null — when the provider last accepted the details (UTC, ISO 8601).
  • status string — connected when the account works; credential_invalid when the provider has since refused it. Connect it again to fix it.
  • inactive_reason string or null — why the account is credential_invalid, as a short machine-readable reason; null while it is connected.
  • expires_at string or null — when the provider will stop accepting the details (UTC), for providers whose tokens expire; null when they do not or the provider does not say.
[
  {
    "offering_id": "hetzner",
    "set": true,
    "account_label": null,
    "verified_at": "2026-09-28T08:12:40Z",
    "status": "connected",
    "inactive_reason": null,
    "expires_at": null
  },
  {
    "offering_id": "upcloud",
    "set": true,
    "account_label": "forge-team",
    "verified_at": "2026-09-20T14:03:11Z",
    "status": "connected",
    "inactive_reason": null,
    "expires_at": "2027-09-20T14:03:11Z"
  }
]

Errors

StatusCodeWhen
401AUTHENTICATION_REQUIREDNo valid credential.
403ORGANIZATION_ACCESS_DENIEDorganization_id or X-Organization-Id names an organization you are not an active member of.
403INSUFFICIENT_PERMISSIONSThe caller does not hold use_forge in the acting organization.
cURL
curl "https://api.aitronos.com/v1/forge/compute/credentials" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response:

[
  {
    "offering_id": "hetzner",
    "set": true,
    "account_label": null,
    "verified_at": "2026-09-28T08:12:40Z",
    "status": "credential_invalid",
    "inactive_reason": "provider_rejected_credential",
    "expires_at": null
  }
]
Previous page
Next page