Publish a ComputerProfileRevision

Atomically publishes the next immutable complete ComputerProfileRevision and advances its head under expected_resource_version. The payload must carry canonically normalized Computer-class requirements, exact optional SandboxProfileRevision and OCI coordinates, presentation-matched screen policy, bounded lifecycle policy, and the Principal author; the server computes and returns the canonical content digest. Existing Computers retain their pinned revision. No provider is selected, allocated, or contacted.

Checkfu support posture: alpha; hosted. No release evidence journey applies to this operation.

POST /v1/computer-profiles/{id}/revisions

Publish a ComputerProfileRevision

cURL

curl --request POST \
  --url https://api.checkfu.com/v1/computer-profiles/{id}/revisions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'checkfu-version: <checkfu-version>' \
  --data '
{
  "expected_resource_version": 1,
  "created_by_principal_id": "<string>",
  "requirements_schema_version": 1,
  "normalized_requirements": {
    "schema_version": 1,
    "execution": [],
    "placement": [],
    "isolation": {},
    "retention": {
      "maximum_seconds": 157680000
    },
    "network": {
      "policy": {
        "action_policy_id": "<string>",
        "action_policy_version": 1
      }
    },
    "locality": {
      "regions": [
        "<string>"
      ],
      "residency_required": true
    },
    "resources": {
      "minimum_vcpu": 512,
      "minimum_memory_mib": 2097152,
      "minimum_disk_mib": 536870912
    }
  },
  "sandbox_profile_revision": {
    "sandbox_profile_id": "<string>",
    "revision_number": 1
  },
  "platform": {
    "os_family": "<string>",
    "architecture": "<string>"
  },
  "image": {
    "reference": "<string>",
    "image_digest": "<string>"
  },
  "screen_policy": {
    "maximum_screens": 8,
    "default_width": 8192,
    "default_height": 8192,
    "maximum_viewers_per_screen": 32
  },
  "lifecycle": {
    "idle_sleep_seconds": 157680000,
    "maximum_active_seconds": 157680000
  }
}
'

201

{
  "profile_id": "<string>",
  "workspace_id": "<string>",
  "revision_number": 1,
  "requirements_schema_version": 1,
  "normalized_requirements": {
    "schema_version": 1,
    "execution": [
      "shell"
    ],
    "lifetime": "run",
    "presentation": "none",
    "human_access": "none",
    "placement": [
      "managed"
    ],
    "isolation": {
      "filesystem": "attachment",
      "browser_profile": "attachment",
      "process_namespace": "attachment",
      "credentials": "grant_bound",
      "clipboard": "disabled",
      "downloads": "attachment"
    },
    "recovery": "none",
    "retention": {
      "mode": "ephemeral_zdr",
      "maximum_seconds": 157680000,
      "export": "forbidden"
    },
    "network": {
      "mode": "none",
      "policy": {
        "action_policy_id": "<string>",
        "action_policy_version": 1
      }
    },
    "locality": {
      "regions": [
        "<string>"
      ],
      "residency_required": true
    },
    "resources": {
      "minimum_vcpu": 512,
      "minimum_memory_mib": 2097152,
      "minimum_disk_mib": 536870912,
      "gpu": "forbidden"
    }
  },
  "sandbox_profile_revision": {
    "sandbox_profile_id": "<string>",
    "revision_number": 1
  },
  "platform": {
    "os_family": "<string>",
    "architecture": "<string>"
  },
  "image": {
    "reference": "<string>",
    "image_digest": "<string>"
  },
  "screen_policy": {
    "maximum_screens": 8,
    "default_width": 8192,
    "default_height": 8192,
    "maximum_viewers_per_screen": 32
  },
  "lifecycle": {
    "idle_sleep_seconds": 157680000,
    "maximum_active_seconds": 157680000
  },
  "content_sha256": "<string>",
  "created_by_principal_id": "<string>",
  "created_at": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version · enum<string> · required

Available options: 2026-08-27

idempotency-key · string

Maximum string length: 255

Path Parameters

id · string · required

Pattern: ^cprof_[0-9a-f]{32}$

Body

application/json

expected_resource_version · integer · required

Required range: x > 0

created_by_principal_id · string · required

Pattern: ^prin_[0-9a-f]{32}$

requirements_schema_version · enum<number> · required

Available options: 1

normalized_requirements · object · required

Show child attributes

sandbox_profile_revision · object | null · required

Show child attributes

platform · object · required

Show child attributes

image · object | null · required

Show child attributes

screen_policy · object | null · required

Show child attributes

lifecycle · object · required

Show child attributes

Response

201

application/json

An immutable complete provider-neutral Computer profile revision bound to its canonical content digest.

profile_id · string · required

Pattern: ^cprof_[0-9a-f]{32}$

workspace_id · string · required

Pattern: ^wrkspc_[0-9a-f]{32}$

revision_number · integer · required

Required range: x > 0

requirements_schema_version · enum<number> · required

Available options: 1

normalized_requirements · object · required

Show child attributes

sandbox_profile_revision · object | null · required

Show child attributes

platform · object · required

Show child attributes

image · object | null · required

Show child attributes

screen_policy · object | null · required

Show child attributes

lifecycle · object · required

Show child attributes

content_sha256 · string · required

Pattern: ^sha256:[0-9a-f]{64}$

created_by_principal_id · string · required

Pattern: ^prin_[0-9a-f]{32}$

created_at · string · required

A canonical UTC ISO-8601 timestamp with millisecond precision.

Maximum string length: 24

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$