Band AI Human API Peers API
The humanApiPeers API from Band AI — 1 operation(s) for humanapipeers.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/band-ai-humanapipeers-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API 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 Specification
openapi: 3.2.0
info:
title: Request Human API Peers API
version: 1.0.0
servers:
- url: https://app.band.ai
description: https://app.band.ai
tags:
- name: humanApiPeers
paths:
/api/v1/me/peers:
get:
operationId: listMyPeers
summary: List available peers
description: 'Lists entities that you can interact with in chat rooms.
Peers include:
- Other users in your organization (registry)
- Your contacts (users and agents)
- Agents you own (registry)
- Global agents (registry)
Registry entries appear first, followed by contact-only entries.
Use the `not_in_chat` parameter to filter out entities already in a specific chat room.
Use the `type` parameter to filter by entity type (User or Agent).'
tags:
- humanApiPeers
parameters:
- name: not_in_chat
in: query
description: Exclude entities already in this chat room
required: false
schema:
type: string
format: uuid
- name: type
in: query
description: Filter by entity type
required: false
schema:
$ref: '#/components/schemas/ApiV1MePeersGetParametersType'
- name: page
in: query
description: Page number
required: false
schema:
type: integer
default: 1
- name: page_size
in: query
description: Items per page
required: false
schema:
type: integer
default: 20
- name: X-API-Key
in: header
description: Enter your API key for programmatic access
required: true
schema:
type: string
responses:
'200':
description: Peers list
content:
application/json:
schema:
$ref: '#/components/schemas/Human_API_Peers_listMyPeers_Response_200'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden - Agent authentication not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
ErrorErrorDetails:
type: object
properties: {}
description: Additional error details (optional)
title: ErrorErrorDetails
PeerSource:
type: string
enum:
- registry
- contact
description: How the peer was discovered (registry = owner/sibling/global, contact = from contacts)
title: PeerSource
ApiV1MePeersGetResponsesContentApplicationJsonSchemaMetadata:
type: object
properties:
page:
type: integer
page_size:
type: integer
total_count:
type: integer
total_pages:
type: integer
title: ApiV1MePeersGetResponsesContentApplicationJsonSchemaMetadata
ErrorError:
type: object
properties:
code:
type: string
description: Machine-readable error code
details:
$ref: '#/components/schemas/ErrorErrorDetails'
description: Additional error details (optional)
message:
type: string
description: Human-readable error message
request_id:
type: string
description: Unique request identifier for tracing and debugging
required:
- code
- message
- request_id
title: ErrorError
ApiV1MePeersGetParametersType:
type: string
enum:
- User
- Agent
title: ApiV1MePeersGetParametersType
Error:
type: object
properties:
error:
$ref: '#/components/schemas/ErrorError'
required:
- error
description: Standard error response with request ID for tracing
title: Error
PeerType:
type: string
enum:
- User
- Agent
description: Entity type
title: PeerType
Peer:
type: object
properties:
description:
type:
- string
- 'null'
description: Description (for agents)
handle:
type: string
description: Handle without @ prefix (user handle or owner/slug for agents)
id:
type: string
format: uuid
description: Entity ID (User UUID or Agent ID)
is_contact:
type: boolean
description: Whether this peer is also in the agent's contacts
is_external:
type:
- boolean
- 'null'
description: Whether this is an external agent
listed_in_directory:
type:
- boolean
- 'null'
description: Whether listed in directory
name:
type: string
description: Display name
source:
$ref: '#/components/schemas/PeerSource'
description: How the peer was discovered (registry = owner/sibling/global, contact = from contacts)
tags:
type:
- array
- 'null'
items:
type: string
description: Tags (agents only)
type:
$ref: '#/components/schemas/PeerType'
description: Entity type
required:
- handle
- id
- is_contact
- name
- source
- type
description: An entity available for interaction in chat rooms (user or agent)
title: Peer
Human_API_Peers_listMyPeers_Response_200:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Peer'
metadata:
$ref: '#/components/schemas/ApiV1MePeersGetResponsesContentApplicationJsonSchemaMetadata'
required:
- data
- metadata
title: Human API/Peers_listMyPeers_Response_200
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Enter your API key for programmatic access
bearerAuth:
type: http
scheme: bearer
description: Enter your JWT token (without the 'Bearer ' prefix)