Coolify Octri Demo
POST/security/keys

Create a private key

Creates a private key for your team. Supply private_key; you can also provide a name and description. A 201 response returns the created key's UUID.

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

3 body fields

Private key details. private_key is required.

descriptionstringoptional
A description for the private key.
namestringoptional
The name to assign to the private key.
private_keystringrequired
The private key value to store.

4 status codes
201Returns the UUID of the created private key.
uuidstringoptional
400Returned when the token is invalid.
messagestringoptional
401Returned when the request is unauthenticated.
messagestringoptional
422Returned when the request fails validation.
errorsobjectoptional
messagestringoptional

Error handling

A 400 is returned when the token is invalid. A 401 is returned when the request is unauthenticated. A 422 is returned when input validation fails; private_key is required.