CVMs

:::note[Base URL] https://prism.ultraviolet.rs/backends :::

Create CVM

Endpoint

POST /{domainID}/cvms/{provider}/{vcpu}/{cc_platform}

The url parameters are as follows:

<workspace_id>: The ID of the workspace where the CVM will be created.
<provider>: The backend provider to use for the CVM (supported are azure, gcp, external and ultraviolet).
<vcpu>: The number of virtual CPUs to allocate for the CVM.
<ccPlatform>: The cloud platform to use for the CVM, currently supported values are Intel TDX and `SEV SNP

Body

{
  "name": "example-cvm",
  "agent_log_level": "info"
}

cURL Example

curl -X POST "https://prism.ultraviolet.rs/backends/c1adf32-3dac-4aad-bead-ae96fe071239/cvms/aws/2/sev-snp?domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"example-cvm", "agent_log_level":"info"}'

Response

201 Created

List CVMs

Endpoint

GET /{domainID}/cvms

Optional Query Parameters

limit, offset, name, status, days, cc_platform

cURL Example

curl -X GET "https://prism.ultraviolet.rs/backends/c1adf32-3dac-4aad-bead-ae96fe071239/cvms?domainID=c1adf32-3dac-4aad-bead-ae96fe071239&limit=10" \
  -H "Authorization: Bearer <token>"

Sample Response

{
  "cvms": [
    {
      "id": "cvm-123",
      "name": "example-cvm",
      "cvm_id": "cvm-123",
      "agent_url": "https://agent.example.com",
      "status": "running",
      "state": "provisioned",
      "created_at": "2025-07-17T09:00:00Z",
      "deleted_at": "0001-01-01T00:00:00Z",
      "provider": "aws",
      "vcpus": 2,
      "attestation": "base64-blob",
      "attestation_token": "base64-token",
      "agent_log_level": "info",
      "monthly_cost_estimate": "$12.34",
      "cc_platform": "sev-snp"
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}

View CVM

Endpoint

GET /{domainID}/cvms/{id}

cURL Example

curl -X GET "https://prism.ultraviolet.rs/backends/c1adf32-3dac-4aad-bead-ae96fe071239/cvms/cvm-123?domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>"

Sample Response

{
  "id": "cvm-123",
  "name": "example-cvm",
  "cvm_id": "cvm-123",
  "agent_url": "https://agent.example.com",
  "status": "running",
  "state": "provisioned",
  "created_at": "2025-07-17T09:00:00Z",
  "deleted_at": "0001-01-01T00:00:00Z",
  "provider": "aws",
  "vcpus": 2,
  "attestation": "base64-blob",
  "attestation_token": "base64-token",
  "agent_log_level": "info",
  "monthly_cost_estimate": "$12.34",
  "cc_platform": "sev-snp"
}

Delete CVM

Endpoint

DELETE /{domainID}/cvms/{id}

cURL Example

curl -X DELETE "https://prism.ultraviolet.rs/backends/c1adf32-3dac-4aad-bead-ae96fe071239/cvms/cvm-123?domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>"

Response

204 No Content

View CVM Statistics

Endpoint

GET /{domainID}/cvms/{id}/statistics

Query Parameters

days: duration window to retrieve stats

cURL Example

curl -X GET "https://prism.ultraviolet.rs/backends/c1adf32-3dac-4aad-bead-ae96fe071239/cvms/cvm-123/statistics?domainID=c1adf32-3dac-4aad-bead-ae96fe071239&days=7" \
  -H "Authorization: Bearer <token>"

Sample Response

{
  "cvm_stats": [
    {
      "id": "stat-1",
      "cvm_id": "cvm-123",
      "timestamp": "2025-07-17T08:00:00Z",
      "status": true
    },
    {
      "id": "stat-2",
      "cvm_id": "cvm-123",
      "timestamp": "2025-07-16T08:00:00Z",
      "status": false
    }
  ]
}

Fetch Attestation Policy

Endpoint

GET /{domainID}/cvms/{id}/attestation_policy

cURL Example

curl -X GET "https://prism.ultraviolet.rs/backends/c1adf32-3dac-4aad-bead-ae96fe071239/cvms/cvm-123/attestation_policy?domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>"

Sample Response

{
  "attestation_policy": "base64-policy-blob"
}

On this page