kms/docs/sdks/languages/go.mdx

---
title: "KMS Go SDK"
sidebarTitle: "Go"
icon: "/images/sdks/languages/go.svg"
---

If you're working with Go, the official KMS Go SDK package is the easiest way to fetch and work with secrets for your application.

- [Package](https://pkg.go.dev/github.com/kms/go-sdk)
- [Github Repository](https://github.com/kms/go-sdk)

# Basic Usage

```go
package main

import (
  "fmt"
  "os"
  "context"
  kms "github.com/kms/go-sdk"
)

func main() {

	client := kms.NewKMSClient(context.Background(), kms.Config{
		SiteUrl: "https://kms.hanzo.ai", // Optional, default is https://kms.hanzo.ai
    AutoTokenRefresh: true, // Wether or not to let the SDK handle the access token lifecycle. Defaults to true if not specified.
	})

	_, err := client.Auth().UniversalAuthLogin("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")

	if err != nil {
		fmt.Printf("Authentication failed: %v", err)
		os.Exit(1)
	}

	apiKeySecret, err := client.Secrets().Retrieve(kms.RetrieveSecretOptions{
		SecretKey:   "API_KEY",
		Environment: "dev",
		ProjectID:   "YOUR_PROJECT_ID",
		SecretPath:  "/",
	})

	if err != nil {
		fmt.Printf("Error: %v", err)
		os.Exit(1)
	}

	fmt.Printf("API Key Secret: %v", apiKeySecret)

}
```

This example demonstrates how to use the KMS Go SDK in a simple Go application. The application retrieves a secret named `API_KEY` from the `dev` environment of the `YOUR_PROJECT_ID` project.

<Warning>
  We do not recommend hardcoding your [Machine Identity
  Tokens](/documentation/platform/identities/machine-identities). Setting it as
  an environment variable would be best.
</Warning>

# Installation

```console
$ go get github.com/kms/go-sdk
```

# Configuration

Import the SDK and create a client instance.

```go
client := kms.NewKMSClient(context.Background(), kms.Config{
		SiteUrl: "https://kms.hanzo.ai", // Optional, default is https://api.kms.hanzo.ai
	})
```

### Configuration Options

<ParamField query="options" type="object">
    <Expandable title="properties">
        <ParamField query="SiteUrl" type="string" optional default="https://kms.hanzo.ai">
            The URL of the KMS API..
        </ParamField>

        <ParamField query="UserAgent" type="string">
            Optionally set the user agent that will be used for HTTP requests. _(Not recommended)_
        </ParamField>

        <ParamField query="AutoTokenRefresh" type="boolean" default={true} optional>
            Whether or not to let the SDK handle the access token lifecycle. Defaults to true if not specified.
        </ParamField>

        <ParamField query="SilentMode" type="boolean" default={false} optional>
            Whether or not to suppress logs such as warnings from the token refreshing process. Defaults to false if not specified.
        </ParamField>

        <ParamField query="CacheExpiryInSeconds" type="number" default={0} optional>
            Defines how long certain responses should be cached in memory, in seconds. When set to a positive value, responses from specific methods (like secret fetching) will be cached for this duration. Set to 0 to disable caching.
        </ParamField>

        <ParamField query="CustomHeaders" type="map[string]string" optional>
            Allows you to pass custom headers to the HTTP requests made by the SDK. Expected format is a map of `Header1: Value1, Header2: Value 2`.
        </ParamField>
    </Expandable>

</ParamField>

# Automatic token refreshing

The KMS Go SDK supports automatic token refreshing. After using one of the auth methods such as Universal Auth, the SDK will automatically renew and re-authenticate when needed.
This behavior is enabled by default, but you can opt-out by setting `AutoTokenRefresh` to `false` in the client settings.

```go
  client := kms.NewKMSClient(context.Background(), kms.Config{
    AutoTokenRefresh: false, // <- Disable automatic token refreshing
  })
```

When using automatic token refreshing it's important to understand how your application uses the Infiiscal client. If you are instantiating new instances of the client often, it's important to cancel the context when the client is no longer needed to avoid the token refreshing process from running indefinitely.

```go
  ctx, cancel := context.WithCancel(context.Background())
  defer cancel() // Cancel the context when the client is no longer needed

  client := kms.NewKMSClient(ctx, kms.Config{
    AutoTokenRefresh: true,
  })

  // Use the client
```

This is only necessary if you are creating multiple instances of the client, and those instances are deleted or otherwise removed throughout the application lifecycle.
If you are only creating one instance of the client, and it will be used throughout the lifetime of your application, you don't need to worry about this.

# Authentication

The SDK supports a variety of authentication methods. The most common authentication method is Universal Auth, which uses a client ID and client secret to authenticate.

#### Universal Auth

**Using environment variables**

Call `.Auth().UniversalAuthLogin()` with empty arguments to use the following environment variables:

- `KMS_UNIVERSAL_AUTH_CLIENT_ID` - Your machine identity client ID.
- `KMS_UNIVERSAL_AUTH_CLIENT_SECRET` - Your machine identity client secret.

**Using the SDK directly**

```go
_, err := client.Auth().UniversalAuthLogin("CLIENT_ID", "CLIENT_SECRET")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

#### GCP ID Token Auth

<Info>
  Please note that this authentication method will only work if you're running
  your application on Google Cloud Platform. Please [read
  more](/documentation/platform/identities/gcp-auth) about this authentication
  method.
</Info>

**Using environment variables**

Call `.Auth().GcpIdTokenAuthLogin()` with empty arguments to use the following environment variables:

- `KMS_GCP_AUTH_IDENTITY_ID` - Your KMS Machine Identity ID.

**Using the SDK directly**

```go
_, err := client.Auth().GcpIdTokenAuthLogin("YOUR_MACHINE_IDENTITY_ID")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

#### GCP IAM Auth

**Using environment variables**

Call `.Auth().GcpIamAuthLogin()` with empty arguments to use the following environment variables:

- `KMS_GCP_IAM_AUTH_IDENTITY_ID` - Your KMS Machine Identity ID.
- `KMS_GCP_IAM_SERVICE_ACCOUNT_KEY_FILE_PATH` - The path to your GCP service account key file.

**Using the SDK directly**

```go
_, err = client.Auth().GcpIamAuthLogin("MACHINE_IDENTITY_ID", "SERVICE_ACCOUNT_KEY_FILE_PATH")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

#### AWS IAM Auth

<Info>
  Please note that this authentication method will only work if you're running
  your application on AWS. Please [read
  more](/documentation/platform/identities/aws-auth) about this authentication
  method.
</Info>

**Using environment variables**

Call `.Auth().AwsIamAuthLogin()` with empty arguments to use the following environment variables:

- `KMS_AWS_IAM_AUTH_IDENTITY_ID` - Your KMS Machine Identity ID.

**Using the SDK directly**

```go
_, err = client.Auth().AwsIamAuthLogin("MACHINE_IDENTITY_ID")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

#### Azure Auth

<Info>
  Please note that this authentication method will only work if you're running
  your application on Azure. Please [read
  more](/documentation/platform/identities/azure-auth) about this authentication
  method.
</Info>

**Using environment variables**

Call `.Auth().AzureAuthLogin()` with empty arguments to use the following environment variables:

- `KMS_AZURE_AUTH_IDENTITY_ID` - Your KMS Machine Identity ID.

**Using the SDK directly**

```go
_, err = client.Auth().AzureAuthLogin("MACHINE_IDENTITY_ID")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

#### Kubernetes Auth

<Info>
  Please note that this authentication method will only work if you're running
  your application on Kubernetes. Please [read
  more](/documentation/platform/identities/kubernetes-auth) about this
  authentication method.
</Info>

**Using environment variables**

Call `.Auth().KubernetesAuthLogin()` with empty arguments to use the following environment variables:

- `KMS_KUBERNETES_IDENTITY_ID` - Your KMS Machine Identity ID.
- `KMS_KUBERNETES_SERVICE_ACCOUNT_TOKEN_PATH_ENV_NAME` - The environment variable name that contains the path to the service account token. This is optional and will default to `/var/run/secrets/kubernetes.io/serviceaccount/token`.

**Using the SDK directly**

```go
// Service account token path will default to /var/run/secrets/kubernetes.io/serviceaccount/token if empty value is passed
_, err = client.Auth().KubernetesAuthLogin("MACHINE_IDENTITY_ID", "SERVICE_ACCOUNT_TOKEN_PATH")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

#### JWT Auth

<Info>
  Please note that this authentication method requires a valid JWT token from
  your JWT issuer. Please [read
  more](/documentation/platform/identities/jwt-auth) about this authentication
  method.
</Info>

**Using the SDK**

```go
credential, err := client.Auth().JwtAuthLogin("MACHINE_IDENTITY_ID", "JWT_TOKEN")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

#### LDAP Auth

<Info>
  Please note that this authentication method requires LDAP credentials. Please
  [read more](/documentation/platform/identities/ldap-auth/general) about this
  authentication method.
</Info>

**Using environment variables**

You can set the `KMS_LDAP_AUTH_IDENTITY_ID` environment variable and pass empty string for the identity ID:

```go
credential, err := client.Auth().LdapAuthLogin("", "LDAP_USERNAME", "LDAP_PASSWORD")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

**Using the SDK directly**

```go
credential, err := client.Auth().LdapAuthLogin("MACHINE_IDENTITY_ID", "LDAP_USERNAME", "LDAP_PASSWORD")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

#### OCI Auth

<Info>
  Please note that this authentication method will only work if you're running
  your application on Oracle Cloud Infrastructure. Please [read
  more](/documentation/platform/identities/oci-auth) about this authentication
  method.
</Info>

**Using environment variables**

You can set the `KMS_OCI_AUTH_IDENTITY_ID` environment variable and omit the `IdentityID` field:

```go
credential, err := client.Auth().OciAuthLogin(kms.OciAuthLoginOptions{
  UserID:      "USER_OCID",
  TenancyID:   "TENANCY_OCID",
  Fingerprint: "FINGERPRINT",
  PrivateKey:  "PRIVATE_KEY",
  Region:      "REGION",
})

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

**Using the SDK directly**

```go
credential, err := client.Auth().OciAuthLogin(kms.OciAuthLoginOptions{
  IdentityID:  "MACHINE_IDENTITY_ID",
  UserID:      "USER_OCID",
  TenancyID:   "TENANCY_OCID",
  Fingerprint: "FINGERPRINT",
  PrivateKey:  "PRIVATE_KEY",
  Region:      "REGION",
  Passphrase:  nil, // Optional: pointer to string if your private key has a passphrase
})

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

**OciAuthLoginOptions fields:**

- `IdentityID` (string) - Your KMS Machine Identity ID. Can be set via `KMS_OCI_AUTH_IDENTITY_ID` environment variable.
- `UserID` (string) - Your OCI user OCID.
- `TenancyID` (string) - Your OCI tenancy OCID.
- `Fingerprint` (string) - Your OCI API key fingerprint.
- `PrivateKey` (string) - Your OCI private key (PEM format).
- `Region` (string) - Your OCI region (e.g., `us-ashburn-1`).
- `Passphrase` (\*string) - Optional: pointer to passphrase string if your private key is encrypted.

## Organization Authentication

All SDK authentication methods support logging into a sub-organization that your machine identity has access to. This is optional and only necessary when attempting to authenticate into a sub-organization using an identity created at the root organization.

Use the `.Auth().WithOrganizationSlug("<organization-slug>")` method to specify which organization to authenticate against:

```go
_, err := client.Auth().WithOrganizationSlug("ORGANIZATION_SLUG").UniversalAuthLogin("CLIENT_ID", "CLIENT_SECRET")

if err != nil {
  fmt.Println(err)
  os.Exit(1)
}
```

<Note>
  If no organization slug is provided, the authentication session defaults to
  the organization where the machine identity was originally created.
</Note>

## Secrets

### List Secrets

`client.Secrets().List(options)`

Retrieve all secrets within the KMS project and environment that client is connected to.

```go
secrets, err := client.Secrets().List(kms.ListSecretsOptions{
  ProjectID:          "PROJECT_ID",
  Environment:        "dev",
  SecretPath:         "/foo/bar",
  AttachToProcessEnv: false,
})
```

#### Parameters

<ParamField query="Parameters" type="object">
    <Expandable title="properties">
        <ParamField query="Environment" type="string" required>
            The slug name (dev, prod, etc) of the environment from where secrets should be fetched from.
        </ParamField>

        <ParamField query="ProjectID" type="string">
            The project ID where the secret lives in.
        </ParamField>

         <ParamField query="SecretPath" type="string" optional>
            The path from where secrets should be fetched from.
        </ParamField>

        <ParamField query="AttachToProcessEnv" type="boolean" default="false" optional>
             Whether or not to set the fetched secrets to the process environment. If true, you can access the secrets like so `System.getenv("SECRET_NAME")`.
        </ParamField>

        <ParamField query="IncludeImports" type="boolean" default="false" optional>
             Whether or not to include imported secrets from the current path. Read about [secret import](/documentation/platform/secret-reference)
        </ParamField>

        <ParamField query="Recursive" type="boolean" default="false" optional>
            Whether or not to fetch secrets recursively from the specified path. Please note that there's a 20-depth limit for recursive fetching.
        </ParamField>

        <ParamField query="ExpandSecretReferences" type="boolean" default="true" optional>
            Whether or not to expand secret references in the fetched secrets. Read about [secret reference](/documentation/platform/secret-reference)
        </ParamField>
    </Expandable>

</ParamField>

###

### Retrieve Secret

`client.Secrets().Retrieve(options)`

Retrieve a secret from KMS. By default `Secrets().Retrieve()` fetches and returns a shared secret.

```go
secret, err := client.Secrets().Retrieve(kms.RetrieveSecretOptions{
  SecretKey:   "API_KEY",
  ProjectID:   "PROJECT_ID",
  Environment: "dev",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="SecretKey" type="string" required>
      The key of the secret to retrieve.
    </ParamField>
    <ParamField query="ProjectID" type="string" required>
      The project ID where the secret lives in.
    </ParamField>
    <ParamField query="Environment" type="string" required>
      The slug name (dev, prod, etc) of the environment from where secrets
      should be fetched from.
    </ParamField>
    <ParamField query="SecretPath" type="string" optional>
      The path from where secret should be fetched from.
    </ParamField>
    <ParamField query="Type" type="string" optional>
      The type of the secret. Valid options are "shared" or "personal". If not
      specified, the default value is "shared".
    </ParamField>
    <ParamField query="Version" type="number" optional>
      The version of the secret to retrieve.
    </ParamField>
  </Expandable>
</ParamField>

###

### Create Secret

`client.Secrets().Create(options)`

Create a new secret in KMS.

```go
secret, err := client.Secrets().Create(kms.CreateSecretOptions{
  ProjectID:   "PROJECT_ID",
  Environment: "dev",

  SecretKey:     "NEW_SECRET_KEY",
  SecretValue:   "NEW_SECRET_VALUE",
  SecretComment: "This is a new secret",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="SecretKey" type="string" required>
      The key of the secret to create.
    </ParamField>
    <ParamField query="SecretValue" type="string" required>
      The value of the secret.
    </ParamField>
    <ParamField query="SecretComment" type="string" optional>
      A comment for the secret.
    </ParamField>
    <ParamField query="ProjectID" type="string" required>
      The project ID where the secret lives in.
    </ParamField>
    <ParamField query="Environment" type="string" required>
      The slug name (dev, prod, etc) of the environment from where secrets
      should be fetched from.
    </ParamField>
    <ParamField query="SecretPath" type="string" optional>
      The path from where secret should be created.
    </ParamField>
    <ParamField query="Type" type="string" optional>
      The type of the secret. Valid options are "shared" or "personal". If not
      specified, the default value is "shared".
    </ParamField>
  </Expandable>
</ParamField>

###

### Update Secret

`client.Secrets().Update(options)`

Update an existing secret in KMS.

```go
secret, err := client.Secrets().Update(kms.UpdateSecretOptions{
  ProjectID:                "PROJECT_ID",
  Environment:              "dev",
  SecretKey:                "NEW_SECRET_KEY",
  NewSecretValue:           "NEW_SECRET_VALUE",
  NewSkipMultilineEncoding: false,
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="SecretKey" type="string" required>
      The key of the secret to update.
    </ParamField>
    <ParamField query="NewSecretValue" type="string" required>
      The new value of the secret.
    </ParamField>
    <ParamField
      query="NewSkipMultilineEncoding"
      type="boolean"
      default="false"
      optional
    >
      Whether or not to skip multiline encoding for the new secret value.
    </ParamField>
    <ParamField query="ProjectID" type="string" required>
      The project ID where the secret lives in.
    </ParamField>
    <ParamField query="Environment" type="string" required>
      The slug name (dev, prod, etc) of the environment from where secrets
      should be fetched from.
    </ParamField>
    <ParamField query="SecretPath" type="string" optional>
      The path from where secret should be updated.
    </ParamField>
    <ParamField query="Type" type="string" optional>
      The type of the secret. Valid options are "shared" or "personal". If not
      specified, the default value is "shared".
    </ParamField>
  </Expandable>
</ParamField>

###

### Delete Secret

`client.Secrets().Delete(options)`

Delete a secret in KMS.

```go
secret, err := client.Secrets().Delete(kms.DeleteSecretOptions{
  ProjectID:   "PROJECT_ID",
  Environment: "dev",
  SecretKey:   "SECRET_KEY",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="SecretKey" type="string">
      The key of the secret to update.
    </ParamField>
    <ParamField query="ProjectID" type="string" required>
      The project ID where the secret lives in.
    </ParamField>
    <ParamField query="Environment" type="string" required>
      The slug name (dev, prod, etc) of the environment from where secrets
      should be fetched from.
    </ParamField>
    <ParamField query="SecretPath" type="string" optional>
      The path from where secret should be deleted.
    </ParamField>
    <ParamField query="Type" type="string" optional>
      The type of the secret. Valid options are "shared" or "personal". If not
      specified, the default value is "shared".
    </ParamField>
  </Expandable>
</ParamField>

### Batch Create Secrets

`client.Secrets().Batch().Create(options)`

Create multiple secrets in KMS.

```go
	createdSecrets, err := client.Secrets().Batch().Create(kms.BatchCreateSecretsOptions{
		Environment: "<environment-slug>",
		SecretPath:  "<secret-path>",
		ProjectID:   "<project-id>",
		Secrets: []kms.BatchCreateSecret{
			{
				SecretKey:   "SECRET-1",
				SecretValue: "test-value-1",
			},
			{
				SecretKey:   "SECRET-2",
				SecretValue: "test-value-2",
			},
		},
	})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="Environment" type="string" required>
      The slug name (dev, prod, etc) of the environment from where secrets should be fetched from.
    </ParamField>
    <ParamField query="ProjectID" type="string" required>
      The project ID where the secret lives in.
    </ParamField>
    <ParamField query="SecretPath" type="string" optional>
      The path from where secret should be created.
    </ParamField>
    <ParamField query="Secrets" type="array" required>
    <Expandable>
      <ParamField query="SecretKey" type="string" required>
        The key of the secret to create.
      </ParamField>
      <ParamField query="SecretValue" type="string" required>
        The value of the secret.
      </ParamField>
      <ParamField query="SecretComment" type="string" optional>
      The comment to add to the secret.
      </ParamField>
      <ParamField query="SkipMultiLineEncoding" type="boolean" optional>
        Whether or not to skip multiline encoding for the secret value.
      </ParamField>
      <ParamField query="TagIDs" type="string[]" optional>
        The tag IDs to associate with the secret.
      </ParamField>

      <ParamField query="SecretMetadata" type="object" optional>
        <Expandable>
          <ParamField query="Key" type="string" required>
            The key of the metadata.
          </ParamField>
          <ParamField query="Value" type="string" required>
            The value of the metadata.
          </ParamField>
        </Expandable>
      </ParamField>
    </Expandable>
    </ParamField>

  </Expandable>
</ParamField>

## Folders

###

### List Folders

`client.Folders().List(options)`

Retrieve all within the KMS project and environment that client is connected to.

```go
folders, err := client.Folders().List(kms.ListFoldersOptions{
  ProjectID:   "PROJECT_ID",
  Environment: "dev",
  Path:        "/",
})
```

#### Parameters

<ParamField query="Parameters" type="object">
    <Expandable title="properties">
        <ParamField query="Environment" type="string" required>
            The slug name (dev, prod, etc) of the environment from where folders should be fetched from.
        </ParamField>

        <ParamField query="ProjectID" type="string">
            The project ID where the folder lives in.
        </ParamField>

         <ParamField query="Path" type="string" optional>
            The path from where folders should be fetched from.
        </ParamField>
    </Expandable>

</ParamField>

###

### Create Folder

`client.Folders().Create(options)`

Create a new folder in KMS.

```go
folder, err := client.Folders().Create(kms.CreateFolderOptions{
  ProjectID:   "PROJECT_ID",
  Name:        "new=folder-name",
  Environment: "dev",
  Path:        "/",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="ProjectID" type="string" required>
      The ID of the project where the folder will be created.
    </ParamField>
    <ParamField query="Environment" type="string" required>
      The slug name (dev, prod, etc) of the environment where the folder will be
      created.
    </ParamField>
    <ParamField query="Path" type="string" optional>
      The path to create the folder in. The root path is `/`.
    </ParamField>
    <ParamField query="Name" type="string" optional>
      The name of the folder to create.
    </ParamField>
  </Expandable>
</ParamField>

###

### Update Folder

`client.Folders().Update(options)`

Update an existing folder in KMS.

```go
folder, err := client.Folders().Update(kms.UpdateFolderOptions{
  ProjectID:   "PROJECT_ID",
  Environment: "dev",
  Path:        "/",
  FolderID:    "FOLDER_ID_TO_UPDATE",
  NewName:     "new-folder-name",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="ProjectID" type="string" required>
      The ID of the project where the folder will be updated.
    </ParamField>
    <ParamField query="Environment" type="string" required>
      The slug name (dev, prod, etc) of the environment from where the folder
      lives in.
    </ParamField>
    <ParamField query="Path" type="string" optional>
      The path from where the folder should be updated.
    </ParamField>
    <ParamField query="FolderID" type="string" required>
      The ID of the folder to update.
    </ParamField>
    <ParamField query="NewName" type="string" required>
      The new name of the folder.
    </ParamField>
  </Expandable>
</ParamField>

###

### Delete Folder

`client.Folders().Delete(options)`

Delete a folder in KMS.

```go
deletedFolder, err := client.Folders().Delete(kms.DeleteFolderOptions{
  // Either folder ID or folder name is required.
  FolderName:  "name-of-folder-to-delete",
  FolderID:    "folder-id-to-delete",
  ProjectID:   "PROJECT_ID",
  Environment: "dev",
  Path:        "/",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
    <Expandable title="properties">
        <ParamField query="FolderName" type="string" optional>
            The name of the folder to delete. Note that either `FolderName` or `FolderID` is required.
        </ParamField>
        <ParamField query="FolderID" type="string" optional>
            The ID of the folder to delete. Note that either `FolderName` or `FolderID` is required.
        </ParamField>

        <ParamField query="ProjectID" type="string" required>
            The ID of the project where the folder lives in.
        </ParamField>
        <ParamField query="Environment" type="string" required>
            The slug name (dev, prod, etc) of the environment from where the folder lives in.
        </ParamField>
        <ParamField query="Path" type="string" optional>
            The path from where the folder should be deleted.
        </ParamField>
    </Expandable>

</ParamField>

## KMS

### Create Key

`client.Kms().Keys().Create(options)`

Create a new key in KMS.

```go
	newKey, err := client.Kms().Keys().Create(kms.KmsCreateKeyOptions{
		KeyUsage:            "<sign-verify>|<encrypt-decrypt>",
		Description:         "<key-description>",
		Name:                "<key-name>",
		EncryptionAlgorithm: "<rsa-4096>|<ecc-nist-p256>|<aes-256-gcm>|<aes-128-gcm>",
		ProjectId:           "<project-id>",
	})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="KeyUsage" type="string" required>
      The usage of the key. Valid options are `sign-verify` or `encrypt-decrypt`.
      The usage dictates what the key can be used for.
    </ParamField>
    <ParamField query="Description" type="string" optional>
      The description of the key.
    </ParamField>
    <ParamField query="Name" type="string" required>
      The name of the key.
    </ParamField>
    <ParamField query="EncryptionAlgorithm" type="string" required>
      The encryption algorithm of the key.

      Valid options for Signing/Verifying keys are:
      - `rsa-4096`
      - `ecc-nist-p256`

      Valid options for Encryption/Decryption keys are:
      - `aes-256-gcm`
      - `aes-128-gcm`
    </ParamField>
    <ParamField query="ProjectId" type="string" required>
      The ID of the project where the key will be created.
    </ParamField>

  </Expandable>
</ParamField>

#### Return (object)

<ParamField query="Return" type="object">
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key that was created.
    </ParamField>
    <ParamField query="Name" type="string" required>
      The name of the key that was created.
    </ParamField>
    <ParamField query="Description" type="string" required>
      The description of the key that was created.
    </ParamField>
    <ParamField query="IsDisabled" type="boolean" required>
      Whether or not the key is disabled.
    </ParamField>
    <ParamField query="OrgId" type="string" required>
      The ID of the organization that the key belongs to.
    </ParamField>
    <ParamField query="ProjectId" type="string" required>
      The ID of the project that the key belongs to.
    </ParamField>
    <ParamField query="KeyUsage" type="string" required>
      The intended usage of the key that was created.
    </ParamField>
    <ParamField query="EncryptionAlgorithm" type="string" required>
      The encryption algorithm of the key that was created.
    </ParamField>
    <ParamField query="Version" type="string" required>
      The version of the key that was created.
    </ParamField>
  </Expandable>
</ParamField>

### Delete Key

`client.Kms().Keys().Delete(options)`

Delete a key in KMS.

```go
deletedKey, err = client.Kms().Keys().Delete(kms.KmsDeleteKeyOptions{
		KeyId: "<key-id>",
	})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key to delete.
    </ParamField>
  </Expandable>
</ParamField>

#### Return (object)

<ParamField query="Return" type="object">
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key that was deleted
    </ParamField>
    <ParamField query="Name" type="string" required>
      The name of the key that was deleted.
    </ParamField>
    <ParamField query="Description" type="string" required>
      The description of the key that was deleted.
    </ParamField>
    <ParamField query="IsDisabled" type="boolean" required>
      Whether or not the key is disabled.
    </ParamField>
    <ParamField query="OrgId" type="string" required>
      The ID of the organization that the key belonged to.
    </ParamField>
    <ParamField query="ProjectId" type="string" required>
      The ID of the project that the key belonged to.
    </ParamField>
    <ParamField query="KeyUsage" type="string" required>
      The intended usage of the key that was deleted.
    </ParamField>
    <ParamField query="EncryptionAlgorithm" type="string" required>
      The encryption algorithm of the key that was deleted.
    </ParamField>
    <ParamField query="Version" type="string" required>
      The version of the key that was deleted.
    </ParamField>
  </Expandable>
</ParamField>

### Signing Data

`client.Kms().Signing().Sign(options)`
Sign data in KMS.

```go
res, err := client.Kms().Signing().SignData(kms.KmsSignDataOptions{
  KeyId:            "<key-id>",
  Data:             "<data-to-sign>", // Must be a base64 encoded string.
  SigningAlgorithm: "<signing-algorithm>", // The signing algorithm that will be used to sign the data.
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key to sign the data with.
    </ParamField>
    <ParamField query="Data" type="string" required>
      The data to sign. Must be a base64 encoded string.
    </ParamField>
    <ParamField query="IsDigest" type="boolean" optional>
      Whether the data is already digested or not.
    </ParamField>
    <ParamField query="SigningAlgorithm" type="string" required>
      The signing algorithm to use. You must use a signing algorithm that matches the key usage.

      <Note>
        If you are unsure about which signing algorithms are available for your key, you can use the `client.Kms().Signing().ListSigningAlgorithms()` method. It will return an array of signing algorithms that are available for your key.
      </Note>

      Valid options for `RSA 4096` keys are:
      - `RSASSA_PSS_SHA_512`
      - `RSASSA_PSS_SHA_384`
      - `RSASSA_PSS_SHA_256`
      - `RSASSA_PKCS1_V1_5_SHA_512`
      - `RSASSA_PKCS1_V1_5_SHA_384`
      - `RSASSA_PKCS1_V1_5_SHA_256`

      Valid options for `ECC NIST P256` keys are:
      - `ECDSA_SHA_512`
      - `ECDSA_SHA_384`
      - `ECDSA_SHA_256`
    </ParamField>

  </Expandable>
</ParamField>

#### Return ([]byte)

<ParamField query="Return" type="[]byte">
  The signature of the data that was signed.
</ParamField>

### Verifying Data

`client.Kms().Signing().Verify(options)`
Verify data in KMS.

```go
res, err := client.Kms().Signing().Verify(kms.KmsVerifyDataOptions{
  KeyId:            "<key-id>",
  Data:             "<data-to-verify>", // Must be a base64 encoded string.
  SigningAlgorithm: "<signing-algorithm>", // The signing algorithm that was used to sign the data.
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key to verify the data with.
    </ParamField>
    <ParamField query="Data" type="string" required>
      The data to verify. Must be a base64 encoded string.
    </ParamField>
    <ParamField query="IsDigest" type="boolean" optional>
      Whether the data is already digested or not.
    </ParamField>
    <ParamField query="SigningAlgorithm" type="string" required>
      The signing algorithm that was used to sign the data.
    </ParamField>
  </Expandable>
</ParamField>

#### Return (object)

<ParamField query="Return" type="object">
  <Expandable title="properties">
    <ParamField query="SignatureValid" type="boolean" required>
      Whether or not the data is valid.
    </ParamField>
    <ParamField query="KeyId" type="string" required>
      The ID of the key that was used to verify the data.
    </ParamField>
    <ParamField query="SigningAlgorithm" type="string" required>
      The signing algorithm that was used to verify the data.
    </ParamField>
  </Expandable>
</ParamField>

### List Signing Algorithms

`client.Kms().Signing().ListSigningAlgorithms(options)`
List signing algorithms in KMS.

```go
res, err := client.Kms().Signing().ListSigningAlgorithms(kms.KmsListSigningAlgorithmsOptions{
  KeyId: "<key-id>",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key to list signing algorithms for.
    </ParamField>
  </Expandable>
</ParamField>

#### Return ([]string)

<ParamField query="Return" type="[]string">
  The signing algorithms that are available for the key.
</ParamField>

### Get Public Key

<Note>
  This method is only available for keys with key usage `sign-verify`. If you
  attempt to use this method on a key that is intended for
  encryption/decryption, it will return an error.
</Note>

`client.Kms().Signing().GetPublicKey(options)`
Get the public key in KMS.

```go
publicKey, err := client.Kms().Signing().GetPublicKey(kms.KmsGetPublicKeyOptions{
  KeyId: "<key-id>",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key to get the public key for.
    </ParamField>
  </Expandable>
</ParamField>

#### Return (string)

<ParamField query="Return" type="string">
  The public key for the key.
</ParamField>

### Encrypt Data

`client.Kms().Encryption().Encrypt(options)`
Encrypt data with a key in KMS KMS.

```go
res, err := client.Kms().EncryptData(kms.KmsEncryptDataOptions{
  KeyId: "<key-id>",
  Plaintext: "<data-to-encrypt>",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key to encrypt the data with.
    </ParamField>
  </Expandable>
</ParamField>

#### Return (string)

<ParamField query="Return" type="string">
  The encrypted data.
</ParamField>

### Decrypt Data

`client.Kms().DecryptData(options)`
Decrypt data with a key in KMS KMS.

```go
res, err := client.Kms().DecryptData(kms.KmsDecryptDataOptions{
  KeyId: "<key-id>",
  Ciphertext: "<encrypted-data>",
})
```

#### Parameters

<ParamField query="Parameters" type="object" optional>
  <Expandable title="properties">
    <ParamField query="KeyId" type="string" required>
      The ID of the key to decrypt the data with.
    </ParamField>
    <ParamField query="Ciphertext" type="string" required>
      The encrypted data to decrypt.
    </ParamField>
  </Expandable>
</ParamField>

#### Return (string)

<ParamField query="Return" type="string">
  The decrypted data.
</ParamField>