# 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](/docs/api-reference/forge-compute/get-host#returns) with `organization`: the organization it is billed to. Use it for a "Mine" view across organizations; [List servers](/docs/api-reference/forge-compute/list-hosts) 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](/docs/api-reference/forge-compute/list-hosts) 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](/docs/api-reference/forge-compute/get-host), [Park a server](/docs/api-reference/forge-compute/park-host), [Resume a server](/docs/api-reference/forge-compute/resume-host), [Delete a server](/docs/api-reference/forge-compute/delete-host) 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. ## Returns **`hosts`** array — your servers in every organization, newest first, each a [server object](/docs/api-reference/forge-compute/get-host#returns) carrying `organization` (`{id, name}`). A server whose record cannot be read is left out rather than failing the whole list. **`orphans`** array — always empty. ```json { "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 | Status | Code | When | | --- | --- | --- | | 401 | `AUTHENTICATION_REQUIRED` | No valid credential. | | 403 | `API_KEY_PERSON_REQUIRED` | An organization API key: it has no person of its own. | ```bash cURL curl "https://api.aitronos.com/v1/forge/compute/hosts/mine" \ -H "Authorization: Bearer $ACCESS_TOKEN" ``` ```python Python SDK # pip install aitronos-sdk # # The Python SDK does not expose a typed `forge_compute` namespace yet, so call # the endpoint directly with the same bearer token you would pass to `Aitronos(...)`. import httpx ACCESS_TOKEN = "your-access-token" headers = {"Authorization": f"Bearer {ACCESS_TOKEN}"} listing = httpx.get( "https://api.aitronos.com/v1/forge/compute/hosts/mine", headers=headers ).json() for server in listing["hosts"]: print(server["name"], server["state"], "billed to", server["organization"]["name"]) # Act on a server in its own organization. parked = listing["hosts"][0] httpx.post( f"https://api.aitronos.com/v1/forge/compute/hosts/{parked['id']}/park", headers={**headers, "X-Organization-Id": parked["organization"]["id"]}, ) ``` ```python Python import os import requests token = os.environ["AITRONOS_TOKEN"] response = requests.get( "https://api.aitronos.com/v1/forge/compute/hosts/mine", headers={"Authorization": f"Bearer {token}"}, ) by_org = {} for host in response.json()["hosts"]: by_org.setdefault(host["organization"]["name"], []).append(host["name"]) print(by_org) ``` ```javascript JavaScript const response = await fetch("https://api.aitronos.com/v1/forge/compute/hosts/mine", { headers: { Authorization: `Bearer ${process.env.AITRONOS_TOKEN}` }, }); const { hosts } = await response.json(); console.log(hosts.map((h) => `${h.name} (${h.organization.name}): ${h.state_label}`)); ``` **Response:** 200 OK ```json { "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": [] } ``` 401 Unauthorized ```json { "success": false, "error": { "code": "AUTHENTICATION_REQUIRED", "message": "Please sign in to continue.", "system_message": "Authentication required", "type": "authentication_error", "status": 401, "details": {}, "trace_id": "3f1c9a52-7d4e-4b8a-9c21-6e0d5f7a8b34", "timestamp": "2026-10-01T09:00:00Z" } } ``` ## Related Resources - [Forge cloud compute overview](/docs/api-reference/forge-compute/introduction) - [List billing organizations](/docs/api-reference/forge-compute/list-billing-organizations) - [Choose the default billing organization](/docs/api-reference/forge-compute/choose-billing-organization) - [List project groups](/docs/api-reference/forge-compute/list-project-groups) - [Register or update a project group](/docs/api-reference/forge-compute/put-project-group) - [Delete a project group](/docs/api-reference/forge-compute/delete-project-group) - [List compute offerings](/docs/api-reference/forge-compute/list-offerings) - [Get offering options](/docs/api-reference/forge-compute/get-offering-options) - [Resolve a free size](/docs/api-reference/forge-compute/resolve-offering-size) - [List connected accounts](/docs/api-reference/forge-compute/list-credentials) - [Connect a cloud account](/docs/api-reference/forge-compute/put-credential) - [Disconnect a cloud account](/docs/api-reference/forge-compute/delete-credential) - [Create a server](/docs/api-reference/forge-compute/create-host) - [List servers](/docs/api-reference/forge-compute/list-hosts) - [List your servers in every organization](/docs/api-reference/forge-compute/list-my-hosts) - [Get a server](/docs/api-reference/forge-compute/get-host) - [Get a server's daily cost and uptime](/docs/api-reference/forge-compute/get-host-usage) - [List a server's running intervals](/docs/api-reference/forge-compute/list-host-intervals) - [List a server's event history](/docs/api-reference/forge-compute/list-host-events) - [Park a server](/docs/api-reference/forge-compute/park-host) - [Resume a server](/docs/api-reference/forge-compute/resume-host) - [Delete a server](/docs/api-reference/forge-compute/delete-host) - [Get compute settings](/docs/api-reference/forge-compute/get-settings) - [Get spend limits](/docs/api-reference/forge-compute/get-limits) - [Change the organization's limits](/docs/api-reference/forge-compute/update-organization-limits) - [Set your own limit](/docs/api-reference/forge-compute/update-my-limit) - [List member limits](/docs/api-reference/forge-compute/list-member-limits) - [Set a member's limit](/docs/api-reference/forge-compute/update-member-limit)