POST/cloud-tokens

Create Cloud Provider Token

Create a new cloud provider token. The token will be validated before being stored.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

3 body fields

Cloud provider token details

namestringrequired
A friendly name for the token.
providerstringrequired
The cloud provider.
Allowed:hetznerdigitaloceanvultrhostinger
tokenstringrequired
The API token for the cloud provider.

4 status codes
201Cloud provider token created.
uuidstringoptional
The UUID of the token.
400Invalid token.
messagestringoptional
401Unauthenticated.
messagestringoptional
422Validation error.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned: Invalid token. A 401 is returned: Unauthenticated. A 422 is returned: Validation error.