# 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](/nitride/cli.md#global-options)
* [Output Options](/nitride/cli.md#output-options)
* [Command Options](/nitride/cli.md#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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enclaive.cloud/nitride/cli/annotation/create.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.