Skip to content
Engram Docs

List vaults

GET
/vaults
curl --request GET \
  --url https://api.engram.page/vaults \
  --header 'Authorization: Bearer <token>'

Lists the user’s active vaults with their note and attachment counts. Pass deleted=true to list soft-deleted vaults instead, or user_code to also echo a suggested_vault_name for an in-progress device link.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
deleted
string

Pass “true” to list soft-deleted vaults instead of active ones.

user_code
string

Device-link user code; echoes a suggested_vault_name.

Responses

Section titled “Responses”

200

Section titled “200”

Vaults

Media typeapplication/json
VaultsResponse
object
suggested_vault_name

Present only when a user_code query param is supplied (device-link flow).

string
nullable
vaults
required
Array<object>
Vault
object
attachment_count
integer
created_at
string format: date-time
nullable
deleted_at
string format: date-time
nullable
description
string
nullable
encrypted

Always true — vaults are encrypted at rest.

boolean
id
required
string format: uuid
is_default
boolean
name
required
string
note_count
integer
purge_at

When a soft-deleted vault is hard-purged (deleted_at + 30d).

string format: date-time
nullable
slug
string
nullable
Examplegenerated
{
  "suggested_vault_name": "example",
  "vaults": [
    {
      "attachment_count": 1,
      "created_at": "2026-04-15T12:00:00Z",
      "deleted_at": "2026-04-15T12:00:00Z",
      "description": "example",
      "encrypted": true,
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "is_default": true,
      "name": "example",
      "note_count": 1,
      "purge_at": "2026-04-15T12:00:00Z",
      "slug": "example"
    }
  ]
}