curl --request POST \
--url https://api.cyberdesk.io/v1/machines \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "<string>",
"fingerprint": "<string>",
"version": "<string>",
"hostname": "<string>",
"os_info": "<string>",
"unkey_key_id": "<string>"
}'
{
"name": "<string>",
"fingerprint": "<string>",
"version": "<string>",
"hostname": "<string>",
"os_info": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organization_id": "<string>",
"unkey_key_id": "<string>",
"status": "connected",
"is_available": true,
"created_at": "2023-11-07T05:31:56Z",
"last_seen": "2023-11-07T05:31:56Z",
"pools": [
{
"name": "<string>",
"description": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organization_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"machine_count": 123
}
]
}
Create a new machine.
The machine will be associated with the authenticated organization.
curl --request POST \
--url https://api.cyberdesk.io/v1/machines \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "<string>",
"fingerprint": "<string>",
"version": "<string>",
"hostname": "<string>",
"os_info": "<string>",
"unkey_key_id": "<string>"
}'
{
"name": "<string>",
"fingerprint": "<string>",
"version": "<string>",
"hostname": "<string>",
"os_info": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organization_id": "<string>",
"unkey_key_id": "<string>",
"status": "connected",
"is_available": true,
"created_at": "2023-11-07T05:31:56Z",
"last_seen": "2023-11-07T05:31:56Z",
"pools": [
{
"name": "<string>",
"description": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"organization_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"machine_count": 123
}
]
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Schema for creating a machine
Successful Response
Machine response schema
Was this page helpful?