Overview
Generate worker join command and cloud-init
curl --request POST \
--url https://api.cnap.tech/v1/clusters/{id}/worker_bootstrap \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expiry_seconds": 3600
}
'{
"token": "<string>",
"expires_at": 123,
"token_placeholder": "<string>",
"cmd_template": "<string>",
"cmd": "<string>",
"cloud_init_template": "<string>",
"cloud_init": "<string>"
}Clusters
Generate worker join command and cloud-init
Returns a join token, bootstrap command template, and cloud-init config for adding a worker node to a KaaS cluster. The token is short-lived.
POST
/
v1
/
clusters
/
{id}
/
worker_bootstrap
Generate worker join command and cloud-init
curl --request POST \
--url https://api.cnap.tech/v1/clusters/{id}/worker_bootstrap \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expiry_seconds": 3600
}
'{
"token": "<string>",
"expires_at": 123,
"token_placeholder": "<string>",
"cmd_template": "<string>",
"cmd": "<string>",
"cloud_init_template": "<string>",
"cloud_init": "<string>"
}Authorizations
Personal Access Token (cnap_pat_...) or OAuth2 JWT. Create tokens at https://cnap.tech/account/tokens
Path Parameters
Cluster ID
Body
application/json
Token expiry in seconds (default 3600, max 86400)
Required range:
60 <= x <= 86400Response
Worker bootstrap info
Short-lived join token
Token expiry (unix seconds)
Placeholder string in templates
Bootstrap command with token placeholder
Bootstrap command with real token (ready to run)
Cloud-init YAML with token placeholder
Cloud-init YAML with real token (ready to use)
⌘I