---
title: "Save an SSH public key to the caller's account"
method: POST
path: "/v1/ssh-keys"
tags: ["SSH keys"]
---

# Save an SSH public key to the caller's account

`POST /v1/ssh-keys`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/ssh-keys`
- Auth: HTTP bearer

Requires a console session or an API key created by a team member. Accepts one plain Ed25519, RSA, ECDSA or OpenSSH security-key public key. An account holds up to 20 keys. Saving an existing key updates its name.

## Request body

- object
  - `public_key` string, required
  - `name` string

## Response `201`

Key saved

- object
  - `fingerprint` string, required

## Other responses

- `default`: 400 invalid_ssh_key, 403 attribution_required for an API key without a creating team member, 409 ssh_key_limit. Authentication, rate limits and transient failures also apply.

## Changes

- **2026-10-01** `ba84c74aeec8`: 1 info
  - endpoint added
- **2026-10-01** `544fef290a54`: 1 breaking
  - api path removed without deprecation
- **2026-09-28** `d4502152ffc3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/ssh-keys/post.md)

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)