# Encrypt data under an organization's named key

<div class="api-op" data-api-operation>
<div class="api-op__main">

<p class="api-endpoint"><span class="method method-post">POST</span> <code>/v1/vault/encrypt</code></p>

Plaintext is base64 (at most 64 KiB decoded). The optional context (at most 16 pairs) is bound to the ciphertext and must be given again to decrypt. Plaintext is never logged or stored.

<dl class="api-facts"><div><dt>Scope</dt><dd><code>vault:use</code></dd></div><div><dt>Auth</dt><dd>Secret key (<code>sk_…</code>)</dd></div><div><dt>Since</dt><dd>1.0</dd></div></dl>

## Request body

<ul class="api-fields">
<li class="api-field">
<p class="api-field__head"><code class="api-field__name">organization</code> <span class="api-field__type">string</span> <span class="api-field__required">Required</span></p>
</li>
<li class="api-field">
<p class="api-field__head"><code class="api-field__name">key</code> <span class="api-field__type">string</span> <span class="api-field__required">Required</span></p>
The key name.
</li>
<li class="api-field">
<p class="api-field__head"><code class="api-field__name">plaintext</code> <span class="api-field__type">string (byte)</span> <span class="api-field__required">Required</span></p>
Base64 (standard, padded); at most 64 KiB decoded.

<p class="api-field__chips">max length 87384</p>
</li>
<li class="api-field">
<p class="api-field__head"><code class="api-field__name">context</code> <span class="api-field__type">VaultContext</span></p>
Additional authenticated data bound to the ciphertext; the same pairs are needed to decrypt.
</li>
</ul>

## Responses

<ul class="api-responses">
<li class="api-response"><span class="api-status api-status--ok">200</span> <span>Ciphertext <span class="api-field__type">VaultEncryptResult</span></span></li>
<li class="api-response"><span class="api-status api-status--neutral">default</span> <span>Any other error, including <a href="/errors/internal_error/">internal_error</a>. Every code is in the error catalogue. <span class="api-field__type">Error</span></span></li>
</ul>

Errors share one shape; see the [error code catalogue](/errors/).

</div>
<div class="api-op__code">

**curl**

```sh wrap
curl -X POST \
  "https://api.ohauthcat.com/v1/vault/encrypt" \
  -H "Authorization: Bearer $OHAUTHCAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "organization": "org_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
  "key": "plan",
  "plaintext": "ZXhhbXBsZQ=="
}'
```

**Node**

```javascript wrap
const response = await fetch("https://api.ohauthcat.com/v1/vault/encrypt", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.OHAUTHCAT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    organization: "org_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
    key: "plan",
    plaintext: "ZXhhbXBsZQ==",
  }),
});
const data = await response.json();
```

**Python**

```python wrap
import os
import requests

response = requests.post(
    "https://api.ohauthcat.com/v1/vault/encrypt",
    headers={"Authorization": f"Bearer {os.environ['OHAUTHCAT_API_KEY']}"},
    json={
        "organization": "org_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
        "key": "plan",
        "plaintext": "ZXhhbXBsZQ==",
    },
)
data = response.json()
```

```json title="Response 200" wrap
{
  "object": "vault_ciphertext",
  "ciphertext": "example_ciphertext",
  "key_id": "vkey_01J9ZQ4M7K2X8V3N5B6C1D0E9F",
  "key_version": 1
}
```

</div>
</div>
