---
title: "Restore compute for a hibernated GCP-hosted on-prem deployment"
method: POST
path: "/onprem/v1/hosted-deployments/{deployment_id}/resume"
tags: ["onprem", "onprem"]
---

# Restore compute for a hibernated GCP-hosted on-prem deployment

`POST /onprem/v1/hosted-deployments/{deployment_id}/resume`

## Path parameters

- `deployment_id` string, required

## Query parameters

- `event_limit` integer

## Request body

- HostedDeploymentResumeRequest — Resume context plus an automatic inactivity-pause cooldown.
  - `reason` string, nullable
  - `inactivity_exempt_days` integer

## Response `200`

Success

- SuccessResponseHostedDeploymentDetail
  - `success` true, required — Flag for it request was successful
  - `data` HostedDeploymentDetail, required — Hosted deployment with recent provisioning events for ops.
    - `deployment` HostedDeploymentRow, required — A row from onprem.hosted_deployment. Provisioner twin of ``defapi.schemas.onprem.HostedDeploymentRow``. Keep cloud_provider / aws_* / coerce validators in lockstep when either changes.
      - `id` union, required
        - string, uuid
        - string
      - `signup_id` union, required
        - string, uuid
        - string
      - `license_id` union, required
        - string, uuid
        - string
      - `deployment_id` string, nullable
      - `status` 'pending' | 'provisioning' | 'ready' | 'failed' | 'destroying' | 'destroyed' | 'upgrade_pending' | 'upgrading' | 'pause_pending' | 'pausing' | 'resume_after_pause' | 'paused' | 'pause_failed' | 'resume_pending' | 'resuming' | 'resume_failed', required
      - `customer_slug` string, required
      - `cloud_provider` 'gcp' | 'aws'
      - `gcp_project_id` string, nullable
      - `gcp_project_number` string, nullable
      - `aws_account_id` string, nullable
      - `aws_cluster_name` string, nullable
      - `region` string
      - `hostname` string, nullable
      - `base_url` string, nullable
      - `image_tag` string, nullable
      - `desired_image_tag` string, nullable
      - `egress_ip` string, nullable
      - `release_channel` 'stable' | 'canary' | 'pinned'
      - `helm_overrides` object, nullable
      - `sso_allowed_domains` string[], nullable
      - `license_key_secret_id` string, required
      - `terraform_state_prefix` string, nullable
      - `migrate_active` boolean
      - `last_error` string, nullable
      - `ready_at` string, date-time, nullable
      - `upgraded_at` string, date-time, nullable
      - `destroyed_at` string, date-time, nullable
      - `auto_pause_exempt_until` string, date-time, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `events` HostedProvisioningEventRow[]
      - `id` union, required
        - string, uuid
        - string
      - `hosted_deployment_id` union, required
        - string, uuid
        - string
      - `actor` string, nullable
      - `event_type` string, required
      - `message` string, nullable
      - `payload` object
      - `created_at` string, date-time, required
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `404` — Resource Not Found
- `409` — Resource Conflict
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)