Skip to main content

API v1 and API Keys

Boldo now provides a new API v1 surface under /api/v1/, together with a redesigned API documentation experience and a dedicated API Keys management experience in Organization > Developer.

Highlights​

  • New versioned REST API under /api/v1/
  • Coverage for assets, relationships, search, analytics, metamodel, and API keys, with read access to users, roles, and access domains
  • OpenAPI outputs for the new API
  • API documentation rebuilt around the v1 specification
  • New API keys management experience under Organization > Developer, with separate sections for My API Keys and Organization API Keys

API key management​

API key management is now much more complete:

  • Multiple API keys per organization instead of a single shared key model
  • Key creation, update, and deletion from the UI
  • Per-key metadata such as name and description
  • Permission types and assigned roles
  • Secret shown once at creation time

Compatibility changes​

  • API v1 is now the primary versioned REST surface
  • Bearer auth handling and rate-limiting behavior are enforced on v1 routes
  • The API docs now render the v1 surface from OpenAPI outputs
  • Composite key addressing is supported in the v1 API

Also included in this release​

  • Bulk create and bulk update for assets, and bulk create for relationships (up to 10,000 items per request)
  • Search endpoints with nested filter support for assets and relationships
  • Analytics aggregation endpoints (count, sum, average, count distinct)
  • API key CRUD from the v1 surface
  • Plan-aware API keys management in the organization settings UI

Why this matters​

This release makes the API more powerful, with more complete permissions and better support for production integrations.