Sesterce Cloud Doc
  • 👋Welcome on Sesterce Cloud
    • 🚀Get Started!
      • Account creation
      • Manage your account
      • Payment & Billing
        • Invoicing
  • 🚀Compute instances
    • Compute Instance configuration
      • Persistent storage (volumes)
      • SSH Keys
    • Terminal connection
  • 💬AI Inference instances
    • Inference Instance configuration
      • Select your Flavor
      • Select your regions
      • Autoscaling limits
    • Edit an inference instance
  • ▶️Manage your instances
  • 🔗API Reference
    • Authentication
    • GPU Cloud instances
    • SSH Keys
    • Volumes
    • Inference Instances
Powered by GitBook
On this page

Was this helpful?

  1. API Reference

SSH Keys

PreviousGPU Cloud instancesNextVolumes

Last updated 3 months ago

Was this helpful?

Create a SSH Key

Use this endpoint to add new SSH keys, especially when integrating new developers or setting up new instances that require secure access.

Use descriptive names for your keys to easily manage multiple SSH credentials.

Retrieve the list of SSH Keys created

Access this endpoint to manage your SSH keys, which is essential for securing access to your instances and maintaining a safe environment.

Mark a SSH Key as default

This endpoint is handy when you want to change the default SSH key for your connections, for example, during regular key rotation for security reasons.

Delete a SSH Key

Use this endpoint to clean up and remove obsolete or compromised SSH keys to maintain the security of your environment.

Regularly review and clean up unused SSH keys to maintain security.

🔗
post

/gpu-cloud/ssh-keys

Header parameters
x-api-keystringrequired

The API Key secret should be sent through this header to authenticate the request.

Body
namestringrequired
Example: my-ssh-key
publicKeystringrequired
Example: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDHRbO3HkzPmp65PR...fAn7Jlb8b61BFh6k= cloud@sesterce
Responses
application/json
application/json
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request POST \
  --url '/gpu-cloud/ssh-keys' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "my-ssh-key",
    "publicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDHRbO3HkzPmp65PR...fAn7Jlb8b61BFh6k= cloud@sesterce"
  }'
201
403
404
{
  "_id": "668f9d8df664e3c028ce5de9",
  "user": "668f9d8df664e3c028ce5de9",
  "name": "ssh-key-name",
  "publicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDHRbO3HkzPmp65PR...fAn7Jlb8b61BFh6k= cloud@sesterce",
  "isDefault": false,
  "createdAt": "2024-10-16T16:05:11.439Z",
  "updatedAt": "2024-11-15T12:46:12.327Z"
}

Return the created ssh key

get

/gpu-cloud/ssh-keys

Header parameters
x-api-keystringrequired

The API Key secret should be sent through this header to authenticate the request.

Responses
application/json
application/json
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --url '/gpu-cloud/ssh-keys' \
  --header 'x-api-key: text'
200
403
404
[
  {
    "_id": "668f9d8df664e3c028ce5de9",
    "user": "668f9d8df664e3c028ce5de9",
    "name": "ssh-key-name",
    "publicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDHRbO3HkzPmp65PR...fAn7Jlb8b61BFh6k= cloud@sesterce",
    "isDefault": false,
    "createdAt": "2024-10-16T16:05:11.439Z",
    "updatedAt": "2024-11-15T12:46:12.327Z"
  }
]

Returns the list of user ssh keys

patch

/gpu-cloud/ssh-keys/{id}/makedefault

Path parameters
idstringrequired
Header parameters
x-api-keystringrequired

The API Key secret should be sent through this header to authenticate the request.

Responses
application/json
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request PATCH \
  --url '/gpu-cloud/ssh-keys/{id}/makedefault' \
  --header 'x-api-key: text'
204
403
404
No body

SSH key marked as default

delete

/gpu-cloud/ssh-keys/{id}

Path parameters
idstringrequired
Header parameters
x-api-keystringrequired

The API Key secret should be sent through this header to authenticate the request.

Responses
application/json
application/json
cURL
JavaScript
Python
HTTP
curl -L \
  --request DELETE \
  --url '/gpu-cloud/ssh-keys/{id}' \
  --header 'x-api-key: text'
204
403
404
No body

SSH key deleted successfully

  • Create a SSH Key
  • POST/gpu-cloud/ssh-keys
  • Retrieve the list of SSH Keys created
  • GET/gpu-cloud/ssh-keys
  • Mark a SSH Key as default
  • PATCH/gpu-cloud/ssh-keys/{id}/makedefault
  • Delete a SSH Key
  • DELETE/gpu-cloud/ssh-keys/{id}