Documentation

Complete guide to using Nera Data Vault API and features

Quick Start

Nera Data Vault provides a powerful API for managing structured data files and database diagrams. All API requests use HTTPS and require proper authentication headers.

Base URL: /api/v1

Note: All GET requests use no-store cache headers to avoid stale data. Use HTTPS for all local development.

Supported File Formats

JSON

JavaScript Object Notation

YAML

YAML Ain't Markup Language

XML

eXtensible Markup Language

TOML

Tom's Obvious Minimal Language

CSV

Comma-Separated Values

SQL

Structured Query Language

DBML

Database Markup Language

INI/ENV/CONF

Configuration files

Markdown

Markdown documentation

GraphQL

GraphQL schemas

HTML/CSS/JS/TS

Web development files

API Endpoints

POST/api/v1/jsonblobs

Create a new file/blob

GET/api/v1/jsonblobs?orgId=&userId=

List files by scope (orgId, userId)

GET/api/v1/jsonblobs/{id}

Get file by ID

PUT/api/v1/jsonblobs/{id}

Update file by ID

DELETE/api/v1/jsonblobs/{id}

Delete file by ID

POST/api/v1/diagrams

Create a new diagram

GET/api/v1/diagrams

List diagrams with pagination

GET/api/v1/diagrams/{id}

Get diagram by ID

PUT/api/v1/diagrams/{id}

Update diagram by ID

POST/api/v1/diagrams/import

Import SQL/DBML to diagram

GET/api/v1/diagrams/{id}/export?format={format}

Export diagram (sql, dbml, png, svg, pdf)

Database Diagrams

  • Create and edit DBML diagrams
  • Import SQL schemas automatically
  • Export to multiple formats (SQL, PNG, SVG, PDF)
  • Real-time collaboration with comments

Sharing & Permissions

  • Public sharing with unique URLs
  • Token-based access control
  • Organization-level permissions
  • Role-based access (Owner, Admin, Editor, Viewer)

Additional Resources