Nexus Overview

Solenoid Nexus is the project management layer that organizes API resources across all Solenoid products into isolated namespaces.

Create projects to separate production from staging, isolate customers in multi-tenant setups, or organize resources by team/environment. Every resource you create (flags, monitors, relays, keys) belongs to a project.

What makes Nexus different

Unlike traditional multi-tenancy where you filter by tenant_id on every query, Nexus uses middleware-based project isolation. Your API key carries projectId context — no query parameters needed. Resources in other projects are invisible to your key.

Capabilities

  • Create projects with human-readable names and auto-generated slugs
  • List projects with cursor-based pagination
  • Update project metadata (name, description)
  • Delete projects with async resource cleanup
  • Overview aggregated resource counts across all 8 products
  • Isolate resources by project — flags, monitors, relays, etc. scoped per-project

Project lifecycle

  1. Signup → default project auto-created
  2. Create additional projects via POST /v1/projects
  3. Organize resources using project_id from API key context
  4. Switch projects by using different API keys or changing key’s projectId
  5. Delete projects → soft delete + async purge queue

Use cases

  • Environment separation — production vs staging vs development projects
  • Multi-tenancy — one project per customer with isolated resources
  • Team organization — engineering, qa, devops projects
  • Compliance — separate projects for different regulatory requirements
  • Cost tracking — meter usage aggregated per-project

How it works

  1. API key authenticates the request and carries project context
  2. Middleware validates the project exists and is not deleted
  3. Product workers filter queries by project ID
  4. Nexus aggregates resource counts via fan-out across all product workers

Pricing

Project management operations (create, list, get, update, delete, overview) are free. No credit cost for CRUD.

Resource operations (create flag, check monitor, etc.) cost credits as normal — pricing unchanged by project isolation.

Next steps