{"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":"Resume 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":"resume-a-server","__idx":0},"children":["Resume a server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Starts a parked server again from its kept disk, in the same location and at the same size, at the price the person confirmed. Get the quote from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-offering-options"},"children":["Get offering options"]}," for the server's own ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size_id"]}," and send it back as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote"]},". The answer is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]}," with the server in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resuming"]},"; the confirmed quote becomes the server's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The server comes back at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting_client"]},", usually with new addresses, and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["keeps its host key"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["host_key_pub"]}," is unchanged and there is no bootstrap key, so the client connects pinned to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["host_key_pub"]},", skips ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["securing"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-progress"},"children":["reports"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["installing"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pairing"]}," as it reaches them and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-ready"},"children":["marks the server ready"]},". Becoming ready removes the park's stored copy and ends its storage charge. If the server cannot be started again, it goes back to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parked"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failure"]}," set and nothing is lost."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Aitronos server is re-priced where its stored copy is kept, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_PRICE_CHANGED"]}," carries the price that resuming will actually cost; confirm it and send it again. Resuming an Aitronos server also passes the organization's spending limit, like a create."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Allowed only while the server is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parked"]},"; asking again while it is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resuming"]}," returns it unchanged. 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"]},". Forge cloud compute must be switched on for the organization, because resuming starts charges again."]},{"$$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}/resume"},"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":"Heading","attributes":{"level":4,"id":"body-parameters","__idx":4},"children":["Body Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote"]}]}," object ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#ef4444 !important","fontWeight":"600 !important","fontStyle":"normal !important"}},"children":["required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The price the person confirmed for resuming, exactly as the options quoted it for the server's location and size."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hourly"]}]}," string, required — e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"0.83\""]},", compared as a decimal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]}," string, required — e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHF"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["catalog_version"]}]}," string, required — the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["catalog_version"]}," the quote came with."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unknown fields are refused."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":5},"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":["resuming"]},"."]},{"$$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\": \"resuming\",\n  \"state_label\": \"Resuming the server\",\n  \"transient\": true,\n  \"step\": null,\n  \"step_started_at\": null,\n  \"state_changed_at\": \"2026-09-29T08:10:12.334519Z\",\n  \"failure\": null,\n  \"ipv4\": null,\n  \"ipv6\": null,\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-29T08:10:12.334519Z\",\n    \"parked_per_gb_month\": \"0.0269\",\n    \"price_verified\": true\n  },\n  \"month_to_date\": \"8.31\",\n  \"notice\": null,\n  \"idle_reminder\": null,\n  \"reconcile_flags\": null,\n  \"actions\": [\"delete\", \"revoke\"],\n  \"created_at\": \"2026-09-28T09:00:00.184066Z\",\n  \"ready_at\": \"2026-09-28T09:03:41.502318Z\",\n  \"parked_at\": \"2026-09-28T18:03:40.905112Z\",\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":6},"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":["402"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_SPEND_LIMIT_REACHED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aitronos servers only: a spending limit cannot absorb one more hour at the quoted price. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.reason"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["spend_limit_reached"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["headroom_below_one_hour"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["compute_share_below_one_hour"]}," (the organization's spending limit); ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["org_compute_limit_reached"]}," (the organization's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-organization-limits"},"children":["monthly limit for Aitronos servers"]},": \"Your organization's monthly limit for Aitronos servers does not allow another server hour. Someone who manages billing can raise it on the Machines page.\"); or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["member_limit_reached"]}," (the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-limits"},"children":["per-person limit"]}," of the server's owner, which is checked even when someone else resumes it: \"Your monthly limit for Aitronos servers (CHF 12.50) does not allow another server hour.\" followed by \"You can raise or clear your own limit on the Machines page.\" when the owner's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-my-limit"},"children":["own limit"]}," applies, else \"Someone who manages billing can raise it on the Machines page.\"). Show ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," as is."]}]},{"$$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":["FORGE_COMPUTE_DISABLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Forge cloud compute is not switched on for the organization."]}]},{"$$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":["FORGE_COMPUTE_OFFERING_NOT_OFFERED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The offering is not offered to you right now: switched off, switched off for your organization, or offered to Aitronos staff only. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," names the offering (for example \"DigitalOcean is not offered right now.\") and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.offering_id"]}," is its id. The server stays parked and can still be deleted."]}]},{"$$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 not parked. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.action"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resume"]},"."]}]},{"$$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_PRICE_CHANGED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The quote no longer matches the live price. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.quote"]}," is the live quote to confirm."]}]},{"$$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_CAPACITY_UNAVAILABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The server's size cannot be ordered in its location. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.reason"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_available_now"]}," (try again later) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["no_longer_offered"]},"; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.alternatives"]}," is empty, because a resumed server keeps its location and size."]}]},{"$$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":["FORGE_COMPUTE_CREDENTIAL_MISSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bring-your-own servers: the account is no longer connected."]}]},{"$$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":["FORGE_COMPUTE_CREDENTIAL_REJECTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bring-your-own servers: the provider no longer accepts the connected account."]}]},{"$$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":["VALIDATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote"]}," is missing or incomplete, or the body has an unknown field."]}]},{"$$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":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["502"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_PROVIDER_UNREACHABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The provider could not be reached to confirm the price."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["503"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_PRICE_UNAVAILABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No verified price, or no spending reading, could be taken right now. Retry after ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.retry_after"]}," seconds."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["503"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_PLATFORM_CAPACITY_REACHED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aitronos servers only: Aitronos servers are at capacity for now, so nothing was resumed. Nothing your organization changes lifts it; try again later (after ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.retry_after"]}," seconds)."]}]}]}]}]}]},{"$$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/resume\" \\\n  -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"quote\": {\"hourly\": \"0.83\", \"currency\": \"CHF\", \"catalog_version\": \"fc-3b8e1f0a9c42\"}}'\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/resume\",\n    headers={\"Authorization\": f\"Bearer {API_KEY}\"},\n    json={\"quote\": {\"hourly\": \"0.83\", \"currency\": \"CHF\", \"catalog_version\": \"fc-3b8e1f0a9c42\"}},\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/resume\",\n    headers={\"Authorization\": f\"Bearer {token}\"},\n    json={\"quote\": {\"hourly\": \"0.83\", \"currency\": \"CHF\", \"catalog_version\": \"fc-3b8e1f0a9c42\"}},\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/resume\",\n  {\n    method: \"POST\",\n    headers: {\n      Authorization: `Bearer ${process.env.AITRONOS_TOKEN}`,\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({\n      quote: { hourly: \"0.83\", currency: \"CHF\", catalog_version: \"fc-3b8e1f0a9c42\" },\n    }),\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\": \"resuming\",\n  \"state_label\": \"Resuming the server\",\n  \"transient\": true,\n  \"step\": null,\n  \"step_started_at\": null,\n  \"state_changed_at\": \"2026-09-29T08:10:12.334519Z\",\n  \"failure\": null,\n  \"ipv4\": null,\n  \"ipv6\": null,\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-29T08:10:12.334519Z\",\n    \"parked_per_gb_month\": \"0.0269\",\n    \"price_verified\": true\n  },\n  \"month_to_date\": \"8.31\",\n  \"notice\": null,\n  \"idle_reminder\": null,\n  \"reconcile_flags\": null,\n  \"actions\": [\"delete\", \"revoke\"],\n  \"created_at\": \"2026-09-28T09:00:00.184066Z\",\n  \"ready_at\": \"2026-09-28T09:03:41.502318Z\",\n  \"parked_at\": \"2026-09-28T18:03:40.905112Z\",\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 Price changed","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_PRICE_CHANGED\",\n    \"message\": \"The price has changed since you confirmed it. Review the new price and confirm again.\",\n    \"system_message\": \"The confirmed Forge compute quote no longer matches the live price\",\n    \"type\": \"client_error\",\n    \"status\": 409,\n    \"details\": {\"quote\": {\"hourly\": \"0.85\", \"currency\": \"CHF\", \"catalog_version\": \"fc-3b8e1f0a9c42\"}},\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":"409 Capacity","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_CAPACITY_UNAVAILABLE\",\n    \"message\": \"This server's size is not available in its location right now, so it cannot be resumed yet. It stays parked: try again later or delete it.\",\n    \"system_message\": \"Resume refused: the parked server's size is not_available_now\",\n    \"type\": \"client_error\",\n    \"status\": 409,\n    \"details\": {\"alternatives\": [], \"reason\": \"not_available_now\"},\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":"403 Forbidden","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_DISABLED\",\n    \"message\": \"Cloud servers are not enabled for this organization.\",\n    \"system_message\": \"Forge cloud compute is disabled for this organization\",\n    \"type\": \"authorization_error\",\n    \"status\": 403,\n    \"details\": {\"feature\": \"forge_compute_enabled\"},\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":7},"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":"Resume a server","id":"resume-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":"Body Parameters","id":"body-parameters","depth":4},{"value":"Returns","id":"returns","depth":2},{"value":"Errors","id":"errors","depth":2},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Resume a server","keywords":["forge","cloud compute","servers","resume","quote"],"seo":{"title":"Resume a server"}},"lastModified":"2026-10-26T18:32:31.578Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/forge-compute/resume-host","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}