{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["api-container","api-content","endpoint","api-examples","code-group","tabs","tab"]},"redocly_category":"API Reference","searchWeight":120,"type":"markdown"},"seo":{"title":"Delete a server","description":"Complete API reference and documentation for Freddy AI-powered backend system by Aitronos","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"delete-a-server","__idx":0},"children":["Delete a server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Deletes a server and everything Forge created for it at the provider: the server, its kept disks and snapshots, its SSH key and its firewall. The answer is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]}," with the server in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleting"]},"; poll ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-host"},"children":["Get a server"]}," until it is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleted"]},". The record stays, in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleted"]},", and is listed for seven days."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Works from every state except ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revoking"]}," (wait until it is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revoked"]},", then delete it); asking again while the server is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleting"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleted"]}," returns it unchanged. Use it for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed_clean"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed_billing"]}," servers too. If the provider does not confirm the deletion, the server ends in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed_billing"]}," — a server may still exist — and deleting it again retries."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Billing."]}," An Aitronos server is charged for every started hour until the provider confirms it is gone; a parked server's snapshot charge ends with it. For a server in your own account, anything the provider still holds after a delete is listed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reconcile_flags"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requires a bearer token (or API key) whose principal holds the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_forge"]}," capability in the acting organization and created the server or holds ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manage_forge"]},". It works while Forge cloud compute is switched off, so switching the feature off never strands a server that costs money."]},{"$$mdtype":"Tag","name":"ApiContainer","attributes":{},"children":[{"$$mdtype":"Tag","name":"ApiContent","attributes":{},"children":[{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"POST","path":"https://api.aitronos.com/v1/forge/compute/hosts/{host_id}/delete"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"path-parameters","__idx":1},"children":["Path Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["host_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#ef4444 !important","fontWeight":"600 !important","fontStyle":"normal !important"}},"children":["required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server's id: the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fchost_"]}," id returned in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", or the UUID sent when the server was created (any letter case, with or without hyphens)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"query-parameters","__idx":2},"children":["Query Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The organization the server belongs to: send its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization.id"]}," (from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-my-hosts"},"children":["List your servers in every organization"]},"). Defaults to your current organization, where a server of another organization is not found. You must be an active member of it, or the request is refused with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 ORGANIZATION_ACCESS_DENIED"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"headers","__idx":3},"children":["Headers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Organization-Id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id"]},", as a header. When both are sent, the query parameter wins."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint takes no body."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":4},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]}," with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-host#returns"},"children":["server object"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleting"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90\",\n  \"offering_id\": \"aitronos\",\n  \"kind\": \"managed\",\n  \"name\": \"build-box\",\n  \"organization\": {\"id\": \"org_3c1e9a7b5d2f4e8a9b0c6d1e2f3a4b5c\", \"name\": \"Acme Engineering\"},\n  \"user_id\": \"usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7\",\n  \"project_group\": {\"id\": \"fpgrp_4b9e2c7a1d3f4e8a9c0b6d2e1f3a5b7c\", \"client_id\": \"grp-clients\", \"name\": \"Clients\"},\n  \"location_id\": \"eu-central\",\n  \"location_label\": \"Germany\",\n  \"size_id\": \"std-16\",\n  \"size_label\": \"16 vCPU · 64 GB\",\n  \"state\": \"deleting\",\n  \"state_label\": \"Deleting the server\",\n  \"transient\": true,\n  \"step\": null,\n  \"step_started_at\": null,\n  \"state_changed_at\": \"2026-09-29T17:30:08.771045Z\",\n  \"failure\": null,\n  \"ipv4\": \"203.0.113.24\",\n  \"ipv6\": \"2001:db8:4f2a::1\",\n  \"ssh_port\": 22,\n  \"ssh_user\": \"forge\",\n  \"bootstrap_host_key_pub\": null,\n  \"host_key_pub\": \"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000\",\n  \"price\": {\n    \"hourly\": \"0.83\",\n    \"monthly_cap\": \"520.30\",\n    \"currency\": \"CHF\",\n    \"source\": \"aitronos\",\n    \"includes_vat\": false,\n    \"catalog_version\": \"fc-3b8e1f0a9c42\",\n    \"quoted_at\": \"2026-09-28T09:00:00.184066Z\",\n    \"parked_per_gb_month\": \"0.0269\",\n    \"price_verified\": true\n  },\n  \"month_to_date\": \"7.47\",\n  \"notice\": null,\n  \"idle_reminder\": null,\n  \"reconcile_flags\": null,\n  \"actions\": [],\n  \"created_at\": \"2026-09-28T09:00:00.184066Z\",\n  \"ready_at\": \"2026-09-28T09:03:41.502318Z\",\n  \"parked_at\": null,\n  \"parked_expires_at\": null,\n  \"deleted_at\": null,\n  \"revoked_at\": null,\n  \"revoke_reason\": null,\n  \"last_activity_at\": \"2026-09-28T09:25:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errors","__idx":5},"children":["Errors"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When"},"children":["When"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHENTICATION_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No valid credential."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ORGANIZATION_ACCESS_DENIED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Organization-Id"]}," names an organization you are not an active member of."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSUFFICIENT_PERMISSIONS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The caller does not hold ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_forge"]}," in the acting organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_HOST_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No server with this id in the acting organization, or it was created by someone else and the caller does not hold ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manage_forge"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["409"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_INVALID_STATE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The server is being revoked. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.action"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delete"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVALID_ID_FORMAT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["host_id"]}," is neither a UUID nor ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fchost_<32 hex>"]},"."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ApiExamples","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"dropdown"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://api.aitronos.com/v1/forge/compute/hosts/fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90/delete\" \\\n  -H \"Authorization: Bearer $ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python SDK","header":{"title":"Python SDK","controls":{"copy":{}}},"source":"# pip install aitronos-sdk\n#\n# The Python SDK does not expose a typed `forge_compute` namespace yet, so call\n# the endpoint directly with the same credential you would pass to `Aitronos(...)`\n# — an API key or a bearer token, both sent as `Authorization: Bearer <value>`.\nimport httpx\n\nAPI_KEY = \"your-api-key\"\n\nserver = httpx.post(\n    \"https://api.aitronos.com/v1/forge/compute/hosts/fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90/delete\",\n    headers={\"Authorization\": f\"Bearer {API_KEY}\"},\n).json()\nprint(server[\"state\"], server[\"actions\"])\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"import os\nimport requests\n\ntoken = os.environ[\"AITRONOS_TOKEN\"]\nresponse = requests.post(\n    \"https://api.aitronos.com/v1/forge/compute/hosts/fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90/delete\",\n    headers={\"Authorization\": f\"Bearer {token}\"},\n)\nif response.status_code == 202:\n    print(response.json()[\"state_label\"])\nelse:\n    print(response.json()[\"error\"][\"message\"])\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","data-title":"JavaScript","header":{"title":"JavaScript","controls":{"copy":{}}},"source":"const response = await fetch(\n  \"https://api.aitronos.com/v1/forge/compute/hosts/fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90/delete\",\n  {\n    method: \"POST\",\n    headers: { Authorization: `Bearer ${process.env.AITRONOS_TOKEN}` },\n  },\n);\nconst server = await response.json();\nconsole.log(response.status, server.state); // 202 ...\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"202 Accepted","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90\",\n  \"offering_id\": \"aitronos\",\n  \"kind\": \"managed\",\n  \"name\": \"build-box\",\n  \"organization\": {\"id\": \"org_3c1e9a7b5d2f4e8a9b0c6d1e2f3a4b5c\", \"name\": \"Acme Engineering\"},\n  \"user_id\": \"usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7\",\n  \"project_group\": {\"id\": \"fpgrp_4b9e2c7a1d3f4e8a9c0b6d2e1f3a5b7c\", \"client_id\": \"grp-clients\", \"name\": \"Clients\"},\n  \"location_id\": \"eu-central\",\n  \"location_label\": \"Germany\",\n  \"size_id\": \"std-16\",\n  \"size_label\": \"16 vCPU · 64 GB\",\n  \"state\": \"deleting\",\n  \"state_label\": \"Deleting the server\",\n  \"transient\": true,\n  \"step\": null,\n  \"step_started_at\": null,\n  \"state_changed_at\": \"2026-09-29T17:30:08.771045Z\",\n  \"failure\": null,\n  \"ipv4\": \"203.0.113.24\",\n  \"ipv6\": \"2001:db8:4f2a::1\",\n  \"ssh_port\": 22,\n  \"ssh_user\": \"forge\",\n  \"bootstrap_host_key_pub\": null,\n  \"host_key_pub\": \"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000\",\n  \"price\": {\n    \"hourly\": \"0.83\",\n    \"monthly_cap\": \"520.30\",\n    \"currency\": \"CHF\",\n    \"source\": \"aitronos\",\n    \"includes_vat\": false,\n    \"catalog_version\": \"fc-3b8e1f0a9c42\",\n    \"quoted_at\": \"2026-09-28T09:00:00.184066Z\",\n    \"parked_per_gb_month\": \"0.0269\",\n    \"price_verified\": true\n  },\n  \"month_to_date\": \"7.47\",\n  \"notice\": null,\n  \"idle_reminder\": null,\n  \"reconcile_flags\": null,\n  \"actions\": [],\n  \"created_at\": \"2026-09-28T09:00:00.184066Z\",\n  \"ready_at\": \"2026-09-28T09:03:41.502318Z\",\n  \"parked_at\": null,\n  \"parked_expires_at\": null,\n  \"deleted_at\": null,\n  \"revoked_at\": null,\n  \"revoke_reason\": null,\n  \"last_activity_at\": \"2026-09-28T09:25:00Z\"\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"409 Conflict","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_INVALID_STATE\",\n    \"message\": \"This server cannot do that in its current state. Wait for it to finish and try again.\",\n    \"system_message\": \"Action 'delete' is not allowed while the host is 'revoking'\",\n    \"type\": \"client_error\",\n    \"status\": 409,\n    \"details\": {\"state\": \"revoking\", \"action\": \"delete\"},\n    \"trace_id\": \"3f1c9a52-7d4e-4b8a-9c21-6e0d5f7a8b34\",\n    \"timestamp\": \"2026-09-28T09:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"404 Not Found","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_HOST_NOT_FOUND\",\n    \"message\": \"This server could not be found. It may have been deleted.\",\n    \"system_message\": \"Forge compute host not found\",\n    \"type\": \"client_error\",\n    \"status\": 404,\n    \"details\": {\"resource\": \"forge_compute_host\"},\n    \"trace_id\": \"3f1c9a52-7d4e-4b8a-9c21-6e0d5f7a8b34\",\n    \"timestamp\": \"2026-09-28T09:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":6},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/introduction"},"children":["Forge cloud compute overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-billing-organizations"},"children":["List billing organizations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/choose-billing-organization"},"children":["Choose the default billing organization"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-project-groups"},"children":["List project groups"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/put-project-group"},"children":["Register or update a project group"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-project-group"},"children":["Delete a project group"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-offerings"},"children":["List compute offerings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-offering-options"},"children":["Get offering options"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/resolve-offering-size"},"children":["Resolve a free size"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-credentials"},"children":["List connected accounts"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/put-credential"},"children":["Connect a cloud account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-credential"},"children":["Disconnect a cloud account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/create-host"},"children":["Create a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-hosts"},"children":["List servers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-my-hosts"},"children":["List your servers in every organization"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-host"},"children":["Get a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-host-usage"},"children":["Get a server's daily cost and uptime"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-host-intervals"},"children":["List a server's running intervals"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-host-events"},"children":["List a server's event history"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-progress"},"children":["Report a setup step"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-host-key"},"children":["Report the server's host key"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-ready"},"children":["Mark a server ready"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-activity"},"children":["Report activity"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/park-host"},"children":["Park a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/resume-host"},"children":["Resume a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-host"},"children":["Delete a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/revoke-host"},"children":["Revoke a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-settings"},"children":["Get compute settings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-settings"},"children":["Update compute settings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-limits"},"children":["Get spend limits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-organization-limits"},"children":["Change the organization's limits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-my-limit"},"children":["Set your own limit"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-member-limits"},"children":["List member limits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-member-limit"},"children":["Set a member's limit"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-orphan"},"children":["Delete a leftover resource"]}]}]}]},"headings":[{"value":"Delete a server","id":"delete-a-server","depth":1},{"value":"Path Parameters","id":"path-parameters","depth":4},{"value":"Query Parameters","id":"query-parameters","depth":4},{"value":"Headers","id":"headers","depth":4},{"value":"Returns","id":"returns","depth":2},{"value":"Errors","id":"errors","depth":2},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Delete a server","keywords":["forge","cloud compute","servers","delete"],"seo":{"title":"Delete a server"}},"lastModified":"2026-10-26T18:32:31.575Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/forge-compute/delete-host","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}