> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# VaultSecret

Metadata for one stored secret. The secret value is never returned. `fingerprint` is an HMAC-SHA-256 of the value keyed with that vault's own data key, so it is comparable only within one vault: equal fingerprints in one vault mean equal values, and rewriting the same value keeps its fingerprint. The same value stored in two vaults (for example a workspace secret and its intern copy) carries different fingerprints, so comparing fingerprints across vaults cannot show that a copy matches or that a rotation propagated. `hosts` and `fingerprint` are `null` only for legacy rows written before host binding was required; storing the secret again assigns hosts.

## Example Usage

```typescript theme={null}
import { VaultSecret } from "@openrouter/sdk/models";

let value: VaultSecret = {
  createdAt: new Date("2026-09-15T17:44:00.000Z"),
  fingerprint:
    "sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  hosts: [
    "api.github.com",
  ],
  name: "github_token",
};
```

## Fields

| Field         | Type                                                                                          | Required             | Description |
| ------------- | --------------------------------------------------------------------------------------------- | -------------------- | ----------- |
| `createdAt`   | [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date) | :heavy\_check\_mark: | N/A         |
| `fingerprint` | *string*                                                                                      | :heavy\_check\_mark: | N/A         |
| `hosts`       | *string*\[]                                                                                   | :heavy\_check\_mark: | N/A         |
| `name`        | *string*                                                                                      | :heavy\_check\_mark: | N/A         |