# Hyperresearch Vault API

**Canonical:** https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-vault-api/  
**Provider:** Hyperresearch — https://apis.io/providers/hyperresearch-ai/  
**Base URL:** https://api.hyperresearch.ai  
**Documentation:** https://hyperresearch.ai/docs/api

Hyperresearch Vault API is one of 16 APIs that [Hyperresearch](https://apis.io/providers/hyperresearch-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Vault. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The vault API from Hyperresearch — 27 operation(s) for vault.

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/admin/backfills/note-titles` | Re-derive stored note titles through the title rule |
| POST | `/v1/vault/fetch` | Fetch one URL into the vault |
| GET | `/v1/vault/status` | Vault status counters |
| GET | `/v1/vault/notes` | List notes |
| POST | `/v1/vault/notes` | Create a note |
| POST | `/v1/vault/notes/batch` | Read up to 50 notes (fenced by default) |
| GET | `/v1/vault/notes/{id}` | Read a note (fenced when fetched from the web) |
| PATCH | `/v1/vault/notes/{id}` | Update status, tags, summary, scores |
| DELETE | `/v1/vault/notes/{id}` | Delete a note and its index rows |
| GET | `/v1/vault/search` | Search the workspace vault (hybrid by default) |
| GET | `/v1/vault/notes/{id}/backlinks` | Notes linking to this note |
| GET | `/v1/vault/hubs` | Most-linked notes |
| GET | `/v1/vault/tags` | Tag census |
| POST | `/v1/vault/sources/check` | Dedup check for a URL |
| GET | `/v1/vault/sources` | Provenance ledger |
| GET | `/v1/vault/claims` | Claims for a note or run |
| POST | `/v1/vault/claims` | Ingest fetcher-extracted claims (idempotent) |
| GET | `/v1/vault/claims/search` | Full-text search over extracted claims |
| GET | `/v1/vault/run-notes` | Notes written by a run |
| POST | `/v1/vault/export` | Export the workspace vault (async job) |
| POST | `/v1/vault/import` | Import a vault archive (async job) |
| POST | `/v1/vault/import-uploads` | Start a resumable vault import upload |
| PUT | `/v1/vault/import-uploads/{id}/parts/{part}` | Upload one fixed-size vault archive part |
| POST | `/v1/vault/import-uploads/{id}/complete` | Assemble a resumable vault upload and queue import |
| DELETE | `/v1/vault/import-uploads/{id}` | Abort a resumable vault upload |
| GET | `/v1/jobs/{id}` | Poll a vault job |
| GET | `/v1/escalations` | List escalations |
| POST | `/v1/escalations/{id}/claim` | Claim a queued escalation (queued → in_progress) |
| POST | `/v1/escalations/{id}/raw/{filename}` | Upload the rescued artifact bytes (R2 `raw/*` only — never indexed) |
| POST | `/v1/escalations/{id}/resolve` | Resolve: extracted text becomes a raw note (upload → extract → note) |
| POST | `/v1/escalations/{id}/abandon` | Abandon an escalation with audit detail |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/hyperresearch-ai/openapi/hyperresearch-ai-vault-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-run-status-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-usage-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-run-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-run-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-answer-search-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-operator-run-detail-schema.json

## Other Hyperresearch APIs (12)

- [Hyperresearch Account API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-account-api/)
- [Hyperresearch agent connections API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-agent-connections-api/)
- [Hyperresearch Answers API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-answers-api/)
- [Hyperresearch Auth API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-auth-api/)
- [Hyperresearch Billing API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-billing-api/)
- [Hyperresearch Demo API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-demo-api/)
- [Hyperresearch Keys API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-keys-api/)
- [Hyperresearch Meta API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-meta-api/)
- [Hyperresearch Projects API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-projects-api/)
- [Hyperresearch Runs API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-runs-api/)
- [Hyperresearch Scholar API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-scholar-api/)
- [Hyperresearch Usage API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-usage-api/)

## Tags

Vault

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-vault-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hyperresearch-ai/.