Skip to main content
POST
Add an organization SSH key
Adding a key registers it for your organization; it does not install it on a machine. Assign it to a reservation or pass its ID when you launch. CLI equivalent: ornn ssh-keys add --public-key-file ~/.ssh/id_ed25519.pub --label laptop.

Authorizations

Authorization
string
header
required

Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.

Path Parameters

organization_id
string<uuid>
required

Your organization ID, from the organizations array of GET /v1/auth/session.

Body

application/json
public_key
string
required

One line containing an OpenSSH public key. Supported types are ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, sk-ssh-ed25519@openssh.com, sk-ecdsa-sha2-nistp256@openssh.com, ssh-rsa, rsa-sha2-256, and rsa-sha2-512.

label
string | null

Optional name for the key. Leading and trailing spaces are removed.

Response

The organization already had this key. outcome is already_registered (returned unchanged) or reactivated (a revoked key is active again).

id
string<uuid>
required
organization_id
string<uuid>
required

Your organization.

public_key
string
required

The OpenSSH public key as registered, including any comment.

fingerprint
string
required

SHA-256 fingerprint in OpenSSH format, such as SHA256:...

status
enum<string>
required
Available options:
active,
revoked
created_at
string<date-time>
required
outcome
enum<string>
required

created for a new key; already_registered when an active key with this fingerprint existed and was returned unchanged; reactivated when a revoked key became active again.

Available options:
created,
already_registered,
reactivated
tenant_id
string<uuid>
deprecated

Same value as organization_id. Use organization_id.

label
string | null

Your name for the key.

revoked_at
string<date-time> | null