# create

### Usage

```
vhsm nitride annotation create @values.json [flags]
```

* `@values.json`: The JSON file containing the annotation payload

#### Structure: @values.json

* "key": The attestation value you want to label (e.g., a hash, PCR, measurement).
* "value": A human‑readable description for that value.
* "created" (optional): Unix timestamp; if omitted, the server sets it.

#### Flags

* [Global HTTP Options](https://docs.enclaive.cloud/nitride/cli/..#global-options)
* [Output Options](https://docs.enclaive.cloud/nitride/cli/..#output-options)
* [Command Options](https://docs.enclaive.cloud/nitride/cli/..#command-options)

#### Example JSON: 

```
{
  "key": "8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo=",
  "value": "Kernel Command Line / Enclaive Buckypaper v1.0.0 / 2025-06-20"
}
```

#### Detailed Explanation

* "key": The exact attestation value you want to annotate. Can be plain text or base64; if it contains reserved URL characters (/, +, =), you may need to URL‑encode it when reading.
* "value": A clear, human‑readable label to make raw values understandable.

#### Example 

Create an annotation

```
vhsm nitride annotation create @values.json
```

#### Output

```
Key        Value
---        -----
created    1755497783
key        8aFCxTWG5+IiPsdOX00aSUKVax/ZrHj6/N+FEXqjRdo=
value      Kernel Command Line / Enclaive Buckypaper v1.0.0 / 2025-06-20
```

{% hint style="info" %}
**Note**: Keys containing “/” are treated like paths in listings. Use the full key when reading/deleting. 
{% endhint %}