Sesterce Cloud Doc
  • 👋Welcome on Sesterce Cloud
    • Glossary
    • Account creation
    • Manage your account
    • Team accounts
    • Payment & Billing
    • Invoicing
  • 🚀Compute instances
    • Configure your Compute Instance
      • SSH Keys management
      • Persistent storage (volumes)
    • Terminal connection
  • 💬AI Inference instances
    • Inference Instance configuration
      • Select your Flavor
      • Select your regions
      • Autoscaling limits
    • Edit an inference instance
    • Chat with Endpoint
  • ▶️Manage your instances
  • 🔗API Reference
    • Authentication
    • GPU Cloud instances
    • SSH Keys
    • Volumes
    • Inference Instances
  • 📗Tutorials
    • Which compute instance for AI models training and inference?
    • Expose AI model from Hugging Face using vLLM
Powered by GitBook
On this page

Was this helpful?

  1. API Reference

SSH Keys

PreviousGPU Cloud instancesNextVolumes

Last updated 7 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.

🔗
get
Header parameters
x-api-keystringRequired

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

Responses
200
Returns the list of user ssh keys
application/json
403
API key invalid
application/json
404
API key not found
application/json
get
GET /gpu-cloud/ssh-keys HTTP/1.1
Host: 
x-api-key: text
Accept: */*

[
  {
    "_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"
  }
]
patch
Path parameters
idstringRequired
Header parameters
x-api-keystringRequired

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

Responses
204
SSH key marked as default
403
API key invalid
application/json
404
Not found
application/json
patch
PATCH /gpu-cloud/ssh-keys/{id}/makedefault HTTP/1.1
Host: 
x-api-key: text
Accept: */*

No content
delete
Path parameters
idstringRequired
Header parameters
x-api-keystringRequired

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

Responses
204
SSH key deleted successfully
403
API key invalid
application/json
404
Not found
application/json
delete
DELETE /gpu-cloud/ssh-keys/{id} HTTP/1.1
Host: 
x-api-key: text
Accept: */*

No content
  • 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}
post
Header parameters
x-api-keystringRequired

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

Body
namestringRequiredExample: my-ssh-key
publicKeystringRequiredExample: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDHRbO3HkzPmp65PR...fAn7Jlb8b61BFh6k= cloud@sesterce
Responses
201
Return the created ssh key
application/json
403
API key invalid
application/json
404
API key not found
application/json
post
POST /gpu-cloud/ssh-keys HTTP/1.1
Host: 
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 125

{
  "name": "my-ssh-key",
  "publicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDHRbO3HkzPmp65PR...fAn7Jlb8b61BFh6k= cloud@sesterce"
}
{
  "_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"
}