BrainstormRouter Agent Profiles API
The agent-profiles API from BrainstormRouter — 7 operation(s) for agent-profiles.
The agent-profiles API from BrainstormRouter — 7 operation(s) for agent-profiles.
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-agent-profiles-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 Agent Profiles 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: agent-profiles
paths:
/auth/agent-profiles:
get:
operationId: authAgent_profilesList
summary: List agent profiles for the tenant
tags:
- agent-profiles
x-br-capability-id: auth.agent_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:
- SupabaseJwt: []
post:
operationId: authAgent_profilesCreate
summary: Create a new agent profile (admin only)
tags:
- agent-profiles
x-br-capability-id: auth.agent_profiles.create
x-br-version: v1
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
agentId:
type: string
required:
- agentId
additionalProperties: {}
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/agent-profiles/lifecycle/{agentId}:
patch:
operationId: authAgent_profilesLifecycle
summary: Transition an agent profile to a new lifecycle state (admin only)
tags:
- agent-profiles
x-br-capability-id: auth.agent_profiles.lifecycle
x-br-version: v1
parameters:
- name: agentId
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
targetState:
type: string
reason:
type: string
required:
- targetState
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:
- SupabaseJwt: []
/auth/agent-profiles/{agentId}:
get:
operationId: authAgent_profilesGet
summary: Get a single agent profile by ID
tags:
- agent-profiles
x-br-capability-id: auth.agent_profiles.get
x-br-version: v1
parameters:
- name: agentId
in: path
required: true
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: []
patch:
operationId: authAgent_profilesUpdate
summary: Patch an agent profile, deep-merging hr_record metadata (admin only)
tags:
- agent-profiles
x-br-capability-id: auth.agent_profiles.update
x-br-version: v1
parameters:
- name: agentId
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
agentId:
type: string
required:
- agentId
additionalProperties: {}
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/agent-profiles/{agentId}/delegate:
post:
operationId: authAgent_profilesDelegate
summary: Delegate a sub-agent under a parent agent (admin only)
tags:
- agent-profiles
x-br-capability-id: auth.agent_profiles.delegate
x-br-version: v1
parameters:
- name: agentId
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$schema: http://json-schema.org/draft-07/schema#
type: object
properties:
childAgentId:
type: string
displayName:
type: string
role:
type: string
budgetUsd:
type: number
ttlSeconds:
type: number
required: []
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:
- SupabaseJwt: []
/auth/agent-profiles/{agentId}/delegation-graph:
get:
operationId: authAgent_profilesDelegation_graph
summary: Build the delegation graph rooted at an agent
tags:
- agent-profiles
x-br-capability-id: auth.agent_profiles.delegation_graph
x-br-version: v1
parameters:
- name: agentId
in: path
required: true
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: []
/auth/agent-profiles/{agentId}/versions:
get:
operationId: authAgent_profilesVersions
summary: Get version history for an agent profile
tags:
- agent-profiles
x-br-capability-id: auth.agent_profiles.versions
x-br-version: v1
parameters:
- name: agentId
in: path
required: true
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: []
/auth/agent/sub-agents/{childAgentId}:
delete:
operationId: authAgentSub_agentsTerminate
summary: Terminate a delegated sub-agent (admin only)
tags:
- agent-profiles
x-br-capability-id: auth.agent.sub_agents.terminate
x-br-version: v1
parameters:
- name: childAgentId
in: path
required: true
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: []
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)