Skip to main content

Certs

Base URL

https://prism.ultraviolet.rs/certs

Issue Certificate​

Endpoint​

POST /{domainID}/certs/issue/cvm/{entityID}

Body​

{
  "ip_addresses": ["10.0.0.1"]
}

cURL Example​

curl -X POST "https://prism.ultraviolet.rs/certs/c1adf32-3dac-4aad-bead-ae96fe071239/certs/issue/computation/comp-123?domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{ "ip_addresses": ["10.0.0.1"] }'

Response​

201 Created

Renew Certificate​

Endpoint​

PATCH /{domainID}/certs/{serialNumber}/renew

cURL Example​

curl -X PATCH "https://prism.ultraviolet.rs/certs/c1adf32-3dac-4aad-bead-ae96fe071239/certs/serial-abc/renew?domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>"

Revoke Certificate​

Endpoint​

PATCH /{domainID}/certs/{serialNumber}/revoke

cURL Example​

curl -X PATCH "https://prism.ultraviolet.rs/certs/c1adf32-3dac-4aad-bead-ae96fe071239/certs/serial-abc/revoke?domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>"

List Certificates​

Endpoint​

GET /{domainID}/certs

Query Parameters​

  • limit, offset, entity_id

cURL Example​

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

Delete Certificates​

Endpoint​

DELETE /{domainID}/certs

Query Parameters​

  • entity_id, domainID

cURL Example​

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

Response​

204 No Content

Retrieve Certificate Download Token​

Endpoint​

GET /{domainID}/certs/{serialNumber}/download/token

cURL Example​

curl -X GET "https://prism.ultraviolet.rs/certs/c1adf32-3dac-4aad-bead-ae96fe071239/certs/serial-abc/download/token?domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>"

Sample Response​

{ "token": "cert-download-token" }

Download Certificate Files​

Endpoint​

GET /{domainID}/certs/{entityID}/download?downloadToken={token}

cURL Example​

curl -X GET "https://prism.ultraviolet.rs/certs/c1adf32-3dac-4aad-bead-ae96fe071239/certs/comp-123/download?downloadToken=cert-download-token&domainID=c1adf32-3dac-4aad-bead-ae96fe071239" \
  -H "Authorization: Bearer <token>"

Sample Response​

{
  "certificate": "base64-cert",
  "private_key": "base64-key",
  "ca": "base64-ca"
}

Download CA Certificates​

Step 1: Retrieve CA Token​

curl -X GET "https://prism.ultraviolet.rs/certs/certs/get-ca/token" \
  -H "Authorization: Bearer <token>"

Step 2: Download CA File​

curl -X GET "https://prism.ultraviolet.rs/certs/certs/download-ca?token=ca-token" \
  -H "Authorization: Bearer <token>"

Response​

(binary .zip or .pem file content)