GET /keys

List added keys

Example request:

GET /keys
Host: mist.io
Accept: application/json; charset=UTF-8

Example response:

[
   {
       "default_key": true,
       "id": "passwordless",
       "machines":
       [
           [
               "2tKqwqDWFFWFDWFESgzqc4SHn3",
               "i-c0ca59c5",
               1389715866.596957,
               "ec2-user",
               "true"
           ]
       ],
       "name": "passwordless"
   },
   {
       "default_key": false,
       "id": "Key2",
       "machines":
       [
       ],
       "name": "Key 2"
   }
]

For each Key a list of associated machines is returned with backend_id, machine_id, username_of_machine, if_sudo in this order

PUT /keys

Add Key

Example request:

PUT /keys
Host: mist.io
Accept: application/json; charset=UTF-8

{
  "id":"MyKey",
  "priv":"-----BEGIN RSA PRIVATE KEY-----OoiknlOnNJNKCAQEAtbBji1OMHW2bS2Va..."
}
Json Parameters:
 
  • id (string) – required Name of new key
  • priv (string) – required Private ssh key
POST /keys

Ask mist to generate a new private key

Example request:

GET /keys
Host: mist.io
Accept: application/json; charset=UTF-8

Example response:

{
  "priv":"-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCA..."
}
DELETE /keys/{key_id}

Delete key

Example request:

DELETE /keys/{key_id}
Host: mist.io
Accept: application/json; charset=UTF-8
PUT /keys/{key_id}

Rename key

Example request:

PUT /keys/{key_id}
Host: mist.io
Accept: application/json; charset=UTF-8

{
  "new_id":"New Key Name"
}
Json Parameters:
 
  • new_id (string) – required New name for key
POST /keys/{key_id}

Set default key

Example request:

POST /keys/{key_id}
Host: mist.io
Accept: application/json; charset=UTF-8
GET /keys/{key_id}/private

Get private key

Example request:

GET /keys/{key_id}/private
Host: mist.io
Accept: application/json; charset=UTF-8

Example response:

"-----BEGIN RSA PRIVATE KEY-----\nMIIE..."
GET /keys/{key_id}/public

Get public key

Example request:

GET /keys/{key_id}/public
Host: mist.io
Accept: application/json; charset=UTF-8

Example response:

"ssh-rsa AAAAB3NzaC1yc2EAAAADAQA..."