Files
autoglue/sdk/ts/docs/SshApi.md
allanice001 334df457ce feat: complete node pool api, sdk and ui
Signed-off-by: allanice001 <allanice001@gmail.com>
2025-11-08 10:22:45 +00:00

13 KiB

SshApi

All URIs are relative to /api/v1

Method HTTP request Description
createSSHKey POST /ssh Create ssh keypair (org scoped)
deleteSSHKey DELETE /ssh/{id} Delete ssh keypair (org scoped)
downloadSSHKey GET /ssh/{id}/download Download ssh key files by ID (org scoped)
getSSHKey GET /ssh/{id} Get ssh key by ID (org scoped)
listPublicSshKeys GET /ssh List ssh keys (org scoped)

createSSHKey

DtoSshResponse createSSHKey(body, xOrgID)

Create ssh keypair (org scoped)

Generates an RSA or ED25519 keypair, saves it, and returns metadata. For RSA you may set bits (2048/3072/4096). Default is 4096. ED25519 ignores bits.

Example

import {
  Configuration,
  SshApi,
} from '@glueops/autoglue-sdk-go';
import type { CreateSSHKeyRequest } from '@glueops/autoglue-sdk-go';

async function example() {
  console.log("🚀 Testing @glueops/autoglue-sdk-go SDK...");
  const config = new Configuration({
    // To configure API key authorization: OrgKeyAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: OrgSecretAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: BearerAuth
    apiKey: "YOUR API KEY",
  });
  const api = new SshApi(config);

  const body = {
    // DtoCreateSSHRequest | Key generation options
    body: ...,
    // string | Organization UUID (optional)
    xOrgID: xOrgID_example,
  } satisfies CreateSSHKeyRequest;

  try {
    const data = await api.createSSHKey(body);
    console.log(data);
  } catch (error) {
    console.error(error);
  }
}

// Run the test
example().catch(console.error);

Parameters

Name Type Description Notes
body DtoCreateSSHRequest Key generation options
xOrgID string Organization UUID [Optional] [Defaults to undefined]

Return type

DtoSshResponse

Authorization

OrgKeyAuth, OrgSecretAuth, BearerAuth

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

HTTP response details

Status code Description Response headers
201 Created -
400 invalid json / invalid bits -
401 Unauthorized -
403 organization required -
500 generation/create failed -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

deleteSSHKey

string deleteSSHKey(id, xOrgID)

Delete ssh keypair (org scoped)

Permanently deletes a keypair.

Example

import { Configuration, SshApi } from "@glueops/autoglue-sdk-go";
import type { DeleteSSHKeyRequest } from "@glueops/autoglue-sdk-go";

async function example() {
  console.log("🚀 Testing @glueops/autoglue-sdk-go SDK...");
  const config = new Configuration({
    // To configure API key authorization: OrgKeyAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: OrgSecretAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: BearerAuth
    apiKey: "YOUR API KEY",
  });
  const api = new SshApi(config);

  const body = {
    // string | SSH Key ID (UUID)
    id: id_example,
    // string | Organization UUID (optional)
    xOrgID: xOrgID_example,
  } satisfies DeleteSSHKeyRequest;

  try {
    const data = await api.deleteSSHKey(body);
    console.log(data);
  } catch (error) {
    console.error(error);
  }
}

// Run the test
example().catch(console.error);

Parameters

Name Type Description Notes
id string SSH Key ID (UUID) [Defaults to undefined]
xOrgID string Organization UUID [Optional] [Defaults to undefined]

Return type

string

Authorization

OrgKeyAuth, OrgSecretAuth, BearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
204 No Content -
400 invalid id -
401 Unauthorized -
403 organization required -
500 delete failed -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

downloadSSHKey

string downloadSSHKey(xOrgID, id, part)

Download ssh key files by ID (org scoped)

Download `part=public|private|both` of the keypair. `both` returns a zip file.

Example

import { Configuration, SshApi } from "@glueops/autoglue-sdk-go";
import type { DownloadSSHKeyRequest } from "@glueops/autoglue-sdk-go";

async function example() {
  console.log("🚀 Testing @glueops/autoglue-sdk-go SDK...");
  const config = new Configuration({
    // To configure API key authorization: OrgKeyAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: OrgSecretAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: BearerAuth
    apiKey: "YOUR API KEY",
  });
  const api = new SshApi(config);

  const body = {
    // string | Organization UUID
    xOrgID: xOrgID_example,
    // string | SSH Key ID (UUID)
    id: id_example,
    // 'public' | 'private' | 'both' | Which part to download
    part: part_example,
  } satisfies DownloadSSHKeyRequest;

  try {
    const data = await api.downloadSSHKey(body);
    console.log(data);
  } catch (error) {
    console.error(error);
  }
}

// Run the test
example().catch(console.error);

Parameters

Name Type Description Notes
xOrgID string Organization UUID [Defaults to undefined]
id string SSH Key ID (UUID) [Defaults to undefined]
part public, private, both Which part to download [Defaults to undefined] [Enum: public, private, both]

Return type

string

Authorization

OrgKeyAuth, OrgSecretAuth, BearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
200 file content -
400 invalid id / invalid part -
401 Unauthorized -
403 organization required -
404 not found -
500 download failed -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

getSSHKey

DtoSshRevealResponse getSSHKey(id, xOrgID, reveal)

Get ssh key by ID (org scoped)

Returns public key fields. Append `?reveal=true` to include the private key PEM.

Example

import { Configuration, SshApi } from "@glueops/autoglue-sdk-go";
import type { GetSSHKeyRequest } from "@glueops/autoglue-sdk-go";

async function example() {
  console.log("🚀 Testing @glueops/autoglue-sdk-go SDK...");
  const config = new Configuration({
    // To configure API key authorization: OrgKeyAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: OrgSecretAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: BearerAuth
    apiKey: "YOUR API KEY",
  });
  const api = new SshApi(config);

  const body = {
    // string | SSH Key ID (UUID)
    id: id_example,
    // string | Organization UUID (optional)
    xOrgID: xOrgID_example,
    // boolean | Reveal private key PEM (optional)
    reveal: true,
  } satisfies GetSSHKeyRequest;

  try {
    const data = await api.getSSHKey(body);
    console.log(data);
  } catch (error) {
    console.error(error);
  }
}

// Run the test
example().catch(console.error);

Parameters

Name Type Description Notes
id string SSH Key ID (UUID) [Defaults to undefined]
xOrgID string Organization UUID [Optional] [Defaults to undefined]
reveal boolean Reveal private key PEM [Optional] [Defaults to undefined]

Return type

DtoSshRevealResponse

Authorization

OrgKeyAuth, OrgSecretAuth, BearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
200 When reveal=true -
400 invalid id -
401 Unauthorized -
403 organization required -
404 not found -
500 fetch failed -

[Back to top] [Back to API list] [Back to Model list] [Back to README]

listPublicSshKeys

Array<DtoSshResponse> listPublicSshKeys(xOrgID)

List ssh keys (org scoped)

Returns ssh keys for the organization in X-Org-ID.

Example

import { Configuration, SshApi } from "@glueops/autoglue-sdk-go";
import type { ListPublicSshKeysRequest } from "@glueops/autoglue-sdk-go";

async function example() {
  console.log("🚀 Testing @glueops/autoglue-sdk-go SDK...");
  const config = new Configuration({
    // To configure API key authorization: OrgKeyAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: OrgSecretAuth
    apiKey: "YOUR API KEY",
    // To configure API key authorization: BearerAuth
    apiKey: "YOUR API KEY",
  });
  const api = new SshApi(config);

  const body = {
    // string | Organization UUID (optional)
    xOrgID: xOrgID_example,
  } satisfies ListPublicSshKeysRequest;

  try {
    const data = await api.listPublicSshKeys(body);
    console.log(data);
  } catch (error) {
    console.error(error);
  }
}

// Run the test
example().catch(console.error);

Parameters

Name Type Description Notes
xOrgID string Organization UUID [Optional] [Defaults to undefined]

Return type

Array<DtoSshResponse>

Authorization

OrgKeyAuth, OrgSecretAuth, BearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status code Description Response headers
200 OK -
401 Unauthorized -
403 organization required -
500 failed to list keys -

[Back to top] [Back to API list] [Back to Model list] [Back to README]