pools

Create Pool

Create a new pool for organizing machines.

post/v1/pools

Request

Base URL
https://api.cyberdesk.io
URL
https://api.cyberdesk.io/v1/pools
Auth
HTTP bearer

Headers

Idempotency-Keystring

Example:550e8400-e29b-41d4-a716-446655440000

Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.

Request body

namestring required

descriptionstring nullable

pool_parametersobject nullable

Pool-level input values that auto-populate runs selecting this pool

pool_sensitive_parametersobject nullable

Pool-level sensitive input aliases (stored in Basis Theory)

Response

Successful Response

namestring required

descriptionstring nullable

pool_parametersobject nullable

Pool-level input values that auto-populate runs selecting this pool

pool_sensitive_parametersobject nullable

Pool-level sensitive input aliases (stored in Basis Theory)

idstring uuid required

organization_idstring required

created_atstring date-time required

updated_atstring date-time required

machine_countinteger nullable

Number of machines in this pool

Changes

No recorded changes to this operation across all 2 revisions of this API.