---
title: "CreateSecretBody"
description: "Request body for creating a Secret."
section: "Reference"
group: "Types"
order: 186
---

## Definition

```ts
interface CreateSecretBody {
  workspaceId: string;
  name: string;
  value: string;
  metadata?: Record<string, unknown> | undefined;
}
```

## Fields

| Field         | Type                                   | Notes                                                                                            |
| ------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `workspaceId` | `string`                               | `required` — Workspace to create the secret in.                                                  |
| `name`        | `string`                               | `required` — Secret name, unique within the workspace.                                           |
| `value`       | `string`                               | `required` — Plaintext secret value. Encrypted at rest (AES-256-GCM); never returned by the API. |
| `metadata`    | `Record<string, unknown> \| undefined` | `optional` — Optional non-secret metadata.                                                       |