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

# Create Vault

> Initialize encrypted vault storage

## Overview

Creates and initializes the user's encrypted vault. This is a one-time setup operation.

## Request Body

<ParamField body="password" type="string" required>
  Vault password/passphrase for encryption
</ParamField>

## Response

<ResponseField name="vault" type="object">
  The created vault object
</ResponseField>

<ResponseField name="status" type="string">
  Request status (`success`)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://app.drime.cloud/api/v1/vault/create \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "password": "your-secure-vault-password"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://app.drime.cloud/api/v1/vault/create', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      password: 'your-secure-vault-password'
    })
  });

  const { vault } = await response.json();
  console.log('Vault created:', vault.id);
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://app.drime.cloud/api/v1/vault/create',
      headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'},
      json={'password': 'your-secure-vault-password'}
  )

  vault = response.json()['vault']
  print(f'Vault created: {vault["id"]}')
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "status": "success",
    "vault": {
      "id": 993,
      "user_id": 15843,
      "salt": "aqtS3SdP/4pgWlGsDewDMw==",
      "check": "YYx1WHsVEwqROOwEzgnXU7fkoyCTVASPkVpVkg==",
      "iv": "VE/FW/XvPwQ2fTB5",
      "created_at": "2025-12-18T16:09:13.000000Z"
    }
  }
  ```
</ResponseExample>

<Warning>
  **Store your vault password securely!** There is no way to recover encrypted files if you forget the password.
</Warning>