Skip to content
/
List your servers in ever...
Last updated

List your servers in every organization

Lists the Forge cloud servers you created in every organization where you are still an active member and hold the use_forge capability, newest first, each as the server object with organization: the organization it is billed to. Use it for a "Mine" view across organizations; List servers lists one organization's servers.

Only your own servers are listed. When you leave an organization, or lose use_forge in it, its servers are no longer listed here. Deleted servers stay in the list for seven days after they were deleted. orphans is always empty here; leftover resources are listed per organization by List servers for members with manage_forge.

Listing never authorizes an action. Read or act on a server in its own organization: send organization.id as the organization_id query parameter or the X-Organization-Id header to Get a server, Park a server, Resume a server, Delete a server and the others; each is admitted there as before.

It names no organization and requires a credential that acts for a person (a bearer token, or a key belonging to a person); a credential confined to some organizations lists those alone. It works while Forge cloud compute is switched off.

GEThttps://api.aitronos.com/v1/forge/compute/hosts/mine

Returns

hosts array — your servers in every organization, newest first, each a server object carrying organization ({id, name}). A server whose record cannot be read is left out rather than failing the whole list.

orphans array — always empty.

{
  "hosts": [
    {
      "id": "fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90",
      "offering_id": "aitronos",
      "kind": "managed",
      "name": "build-box",
      "organization": {
        "id": "org_3c1e9a7b5d2f4e8a9b0c6d1e2f3a4b5c",
        "name": "Acme Engineering"
      },
      "user_id": "usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7",
      "project_group": {
        "id": "fpgrp_4b9e2c7a1d3f4e8a9c0b6d2e1f3a5b7c",
        "client_id": "grp-clients",
        "name": "Clients"
      },
      "location_id": "eu-central",
      "location_label": "Germany",
      "size_id": "std-16",
      "size_label": "16 vCPU · 64 GB",
      "state": "ready",
      "state_label": "Ready",
      "transient": false,
      "step": "ready",
      "step_started_at": "2026-09-28T09:03:41.502318Z",
      "state_changed_at": "2026-09-28T09:03:41.502318Z",
      "failure": null,
      "ipv4": "203.0.113.24",
      "ipv6": "2001:db8:4f2a::1",
      "ssh_port": 22,
      "ssh_user": "forge",
      "bootstrap_host_key_pub": null,
      "host_key_pub": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000",
      "price": {
        "hourly": "0.83",
        "monthly_cap": "520.30",
        "currency": "CHF",
        "source": "aitronos",
        "includes_vat": false,
        "catalog_version": "fc-3b8e1f0a9c42",
        "quoted_at": "2026-09-28T09:00:00.184066Z",
        "parked_per_gb_month": "0.0269",
        "price_verified": true
      },
      "month_to_date": "0.83",
      "notice": null,
      "idle_reminder": null,
      "reconcile_flags": null,
      "actions": ["park", "delete", "revoke"],
      "created_at": "2026-09-28T09:00:00.184066Z",
      "ready_at": "2026-09-28T09:03:41.502318Z",
      "parked_at": null,
      "parked_expires_at": null,
      "deleted_at": null,
      "revoked_at": null,
      "revoke_reason": null,
      "last_activity_at": null
    },
    {
      "id": "fchost_0b7e4d21c9a84f6b8d3e5a1c7f902e64",
      "offering_id": "aitronos",
      "kind": "managed",
      "name": "nightly-tests",
      "organization": {
        "id": "org_8f2d4b6a1c3e4f5a8b7c9d0e1f2a3b4c",
        "name": "Side Project"
      },
      "user_id": "usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7",
      "project_group": null,
      "location_id": "eu-central",
      "location_label": "Germany",
      "size_id": "std-8",
      "size_label": "8 vCPU · 32 GB",
      "state": "parked",
      "state_label": "Parked. The server is saved and not running",
      "transient": false,
      "step": null,
      "step_started_at": null,
      "state_changed_at": "2026-09-28T18:03:40.905112Z",
      "failure": null,
      "ipv4": null,
      "ipv6": null,
      "ssh_port": 22,
      "ssh_user": "forge",
      "bootstrap_host_key_pub": null,
      "host_key_pub": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000",
      "price": {
        "hourly": "0.42",
        "monthly_cap": "261.55",
        "currency": "CHF",
        "source": "aitronos",
        "includes_vat": false,
        "catalog_version": "fc-3b8e1f0a9c42",
        "quoted_at": "2026-09-27T14:12:09.551208Z",
        "parked_per_gb_month": "0.0269",
        "price_verified": true
      },
      "month_to_date": "11.76",
      "notice": null,
      "idle_reminder": null,
      "reconcile_flags": null,
      "actions": ["resume", "delete"],
      "created_at": "2026-09-27T14:12:09.551208Z",
      "ready_at": "2026-09-27T14:15:02.300417Z",
      "parked_at": "2026-09-28T18:03:40.905112Z",
      "parked_expires_at": "2026-10-28T18:03:40.905112Z",
      "deleted_at": null,
      "revoked_at": null,
      "revoke_reason": null,
      "last_activity_at": "2026-09-28T06:40:00Z"
    }
  ],
  "orphans": []
}

Errors

StatusCodeWhen
401AUTHENTICATION_REQUIREDNo valid credential.
403API_KEY_PERSON_REQUIREDAn organization API key: it has no person of its own.
cURL
curl "https://api.aitronos.com/v1/forge/compute/hosts/mine" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response:

{
  "hosts": [
    {
      "id": "fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90",
      "offering_id": "aitronos",
      "kind": "managed",
      "name": "build-box",
      "organization": {
        "id": "org_3c1e9a7b5d2f4e8a9b0c6d1e2f3a4b5c",
        "name": "Acme Engineering"
      },
      "user_id": "usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7",
      "project_group": {
        "id": "fpgrp_4b9e2c7a1d3f4e8a9c0b6d2e1f3a5b7c",
        "client_id": "grp-clients",
        "name": "Clients"
      },
      "location_id": "eu-central",
      "location_label": "Germany",
      "size_id": "std-16",
      "size_label": "16 vCPU · 64 GB",
      "state": "ready",
      "state_label": "Ready",
      "transient": false,
      "step": "ready",
      "step_started_at": "2026-09-28T09:03:41.502318Z",
      "state_changed_at": "2026-09-28T09:03:41.502318Z",
      "failure": null,
      "ipv4": "203.0.113.24",
      "ipv6": "2001:db8:4f2a::1",
      "ssh_port": 22,
      "ssh_user": "forge",
      "bootstrap_host_key_pub": null,
      "host_key_pub": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000",
      "price": {
        "hourly": "0.83",
        "monthly_cap": "520.30",
        "currency": "CHF",
        "source": "aitronos",
        "includes_vat": false,
        "catalog_version": "fc-3b8e1f0a9c42",
        "quoted_at": "2026-09-28T09:00:00.184066Z",
        "parked_per_gb_month": "0.0269",
        "price_verified": true
      },
      "month_to_date": "0.83",
      "notice": null,
      "idle_reminder": null,
      "reconcile_flags": null,
      "actions": ["park", "delete", "revoke"],
      "created_at": "2026-09-28T09:00:00.184066Z",
      "ready_at": "2026-09-28T09:03:41.502318Z",
      "parked_at": null,
      "parked_expires_at": null,
      "deleted_at": null,
      "revoked_at": null,
      "revoke_reason": null,
      "last_activity_at": null
    },
    {
      "id": "fchost_0b7e4d21c9a84f6b8d3e5a1c7f902e64",
      "offering_id": "aitronos",
      "kind": "managed",
      "name": "nightly-tests",
      "organization": {
        "id": "org_8f2d4b6a1c3e4f5a8b7c9d0e1f2a3b4c",
        "name": "Side Project"
      },
      "user_id": "usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7",
      "project_group": null,
      "location_id": "eu-central",
      "location_label": "Germany",
      "size_id": "std-8",
      "size_label": "8 vCPU · 32 GB",
      "state": "parked",
      "state_label": "Parked. The server is saved and not running",
      "transient": false,
      "step": null,
      "step_started_at": null,
      "state_changed_at": "2026-09-28T18:03:40.905112Z",
      "failure": null,
      "ipv4": null,
      "ipv6": null,
      "ssh_port": 22,
      "ssh_user": "forge",
      "bootstrap_host_key_pub": null,
      "host_key_pub": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000",
      "price": {
        "hourly": "0.42",
        "monthly_cap": "261.55",
        "currency": "CHF",
        "source": "aitronos",
        "includes_vat": false,
        "catalog_version": "fc-3b8e1f0a9c42",
        "quoted_at": "2026-09-27T14:12:09.551208Z",
        "parked_per_gb_month": "0.0269",
        "price_verified": true
      },
      "month_to_date": "11.76",
      "notice": null,
      "idle_reminder": null,
      "reconcile_flags": null,
      "actions": ["resume", "delete"],
      "created_at": "2026-09-27T14:12:09.551208Z",
      "ready_at": "2026-09-27T14:15:02.300417Z",
      "parked_at": "2026-09-28T18:03:40.905112Z",
      "parked_expires_at": "2026-10-28T18:03:40.905112Z",
      "deleted_at": null,
      "revoked_at": null,
      "revoke_reason": null,
      "last_activity_at": "2026-09-28T06:40:00Z"
    }
  ],
  "orphans": []
}
Previous page
Next page