BrainstormRouter Mesh API
The mesh API from BrainstormRouter — 20 operation(s) for mesh.
The mesh API from BrainstormRouter — 20 operation(s) for mesh.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/brainstormrouter-com:brainstormrouter-com-mesh-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: BrainstormRouter Mesh API
version: 1.0.0
description: 'Autonomous AI API Engine — multi-tenant gateway that intelligently routes
AI traffic across providers with built-in memory, cost optimization, and
autonomous background processing.
All `/v1/*` endpoints require an API key via `Authorization: Bearer `.'
contact:
name: BrainstormRouter
url: https://brainstormrouter.com
license:
name: Proprietary
identifier: LicenseRef-Proprietary
servers:
- url: https://api.brainstormrouter.com
description: Production
security:
- BearerAuth: []
tags:
- name: mesh
paths:
/auth/mesh/agents:
get:
operationId: authMeshAgents
summary: List mesh agents currently registered for the tenant
tags:
- mesh
x-br-capability-id: auth.mesh.agents
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- SupabaseJwt: []
/auth/mesh/graph:
get:
operationId: authMeshGraph
summary: Live mesh-graph snapshot (nodes + aggregated edges)
tags:
- mesh
x-br-capability-id: auth.mesh.graph
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- SupabaseJwt: []
/auth/mesh/graph/history:
get:
operationId: authMeshGraph_history
summary: Mesh-graph snapshot history (rolling 1–168h window)
tags:
- mesh
x-br-capability-id: auth.mesh.graph_history
x-br-version: v1
parameters:
- name: hours
in: query
required: false
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- SupabaseJwt: []
/v1/mesh/agents:
get:
operationId: systemMeshAgentsList
summary: List registered agents in the mesh for this tenant
tags:
- mesh
x-br-capability-id: system.mesh.agents.list
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/check:
post:
operationId: systemMeshCheck
summary: Evaluate a mesh access decision for source → destination
tags:
- mesh
x-br-capability-id: system.mesh.check
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
sourceSpiffeId:
type: string
minLength: 1
destinationSpiffeIdOrHostname:
type: string
minLength: 1
required:
- sourceSpiffeId
- destinationSpiffeIdOrHostname
additionalProperties: false
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/deregister:
post:
operationId: systemMeshDeregister
summary: Deregister an agent from the mesh (mTLS required)
tags:
- mesh
x-br-capability-id: system.mesh.deregister
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
hostname:
type: string
minLength: 1
required:
- hostname
additionalProperties: false
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- MutualTLS: []
/v1/mesh/execute:
post:
operationId: systemMeshExecute
summary: Run a DAG-based mesh workflow, streaming step progress as SSE
tags:
- mesh
x-br-capability-id: system.mesh.execute
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/forensics:
get:
operationId: systemMeshForensicsList
summary: List forensic snapshots for the tenant
tags:
- mesh
x-br-capability-id: system.mesh.forensics.list
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/forensics/{id}:
get:
operationId: systemMeshForensicsGet
summary: Get a single forensic snapshot by id
tags:
- mesh
x-br-capability-id: system.mesh.forensics.get
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/graph:
get:
operationId: systemMeshGraph
summary: Current mesh graph snapshot for this tenant
tags:
- mesh
x-br-capability-id: system.mesh.graph
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/graph/history:
get:
operationId: systemMeshGraphHistory
summary: Historical mesh graph snapshots over the last N hours
tags:
- mesh
x-br-capability-id: system.mesh.graph.history
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/heartbeat:
post:
operationId: systemMeshHeartbeat
summary: Send a liveness heartbeat for the calling agent (mTLS required)
tags:
- mesh
x-br-capability-id: system.mesh.heartbeat
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
hostname:
type: string
minLength: 1
required:
- hostname
additionalProperties: false
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- MutualTLS: []
/v1/mesh/invoke-did/{target_did}:
post:
operationId: systemMeshInvoke_did
summary: Resolve a target DID via the Capability Registry and forward the invocation to…
tags:
- mesh
x-br-capability-id: system.mesh.invoke_did
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
capability:
type: string
minLength: 1
input: {}
task_id:
type: string
required:
- capability
additionalProperties: false
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- AgentJwt: []
/v1/mesh/invoke/{hostname}:
post:
operationId: systemMeshInvoke
summary: Proxy an A2A call through the mesh (mTLS required)
tags:
- mesh
x-br-capability-id: system.mesh.invoke
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- MutualTLS: []
/v1/mesh/policies:
get:
operationId: systemMeshPoliciesList
summary: List mesh RBAC policies
tags:
- mesh
x-br-capability-id: system.mesh.policies.list
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
post:
operationId: systemMeshPoliciesCreate
summary: Create a mesh allow/deny policy
tags:
- mesh
x-br-capability-id: system.mesh.policies.create
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
sourcePattern:
type: string
minLength: 1
destinationPattern:
type: string
minLength: 1
effect:
type: string
enum:
- allow
- deny
priority:
type: number
description:
type: string
required:
- sourcePattern
- destinationPattern
- effect
additionalProperties: false
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/policies/{id}:
delete:
operationId: systemMeshPoliciesDelete
summary: Delete a mesh policy by id
tags:
- mesh
x-br-capability-id: system.mesh.policies.delete
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/profiles:
get:
operationId: systemMeshProfilesList
summary: List mesh behavioral profiles
tags:
- mesh
x-br-capability-id: system.mesh.profiles.list
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
post:
operationId: systemMeshProfilesCreate
summary: Create a mesh behavioral profile
tags:
- mesh
x-br-capability-id: system.mesh.profiles.create
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
role:
type: string
minLength: 1
maxRps:
type: number
maxPayloadBytes:
type: number
allowedDestinations:
type: array
items:
type: string
maxFanOut:
type: number
maxRequestsPerWindow:
type: number
windowSeconds:
type: number
required:
- role
additionalProperties: false
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/profiles/{role}:
delete:
operationId: systemMeshProfilesDelete
summary: Delete a mesh behavioral profile by role
tags:
- mesh
x-br-capability-id: system.mesh.profiles.delete
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
/v1/mesh/register:
post:
operationId: systemMeshRegister
summary: Register an agent in the service mesh (mTLS required)
tags:
- mesh
x-br-capability-id: system.mesh.register
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
hostname:
type: string
minLength: 1
endpoint:
type: string
minLength: 1
capabilities:
type: array
items:
type: string
machine_id_fingerprint:
type: string
minLength: 1
required:
- hostname
- endpoint
additionalProperties: false
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- MutualTLS: []
/v1/mesh/resolve/{hostname}:
get:
operationId: systemMeshResolve
summary: Resolve a mesh hostname to its agent registration
tags:
- mesh
x-br-capability-id: system.mesh.resolve
x-br-version: v1
responses:
'200':
description: Success
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
propertyNames:
type: string
additionalProperties: {}
security:
- BearerAuth: []
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: API key (e.g. `br_live_...`)
SupabaseJWT:
type: http
scheme: bearer
description: Supabase JWT token (dashboard auth)