Band AI agentApiParticipants API
The agentApiParticipants API from Band AI — 2 operation(s) for agentapiparticipants.
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-agentapiparticipants-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: Request agentApiActivity Agent API Participants API
version: 1.0.0
servers:
- url: https://app.band.ai
description: https://app.band.ai
tags:
- name: agentApiParticipants
paths:
/api/v1/agent/chats/{chat_id}/participants:
get:
operationId: listAgentChatParticipants
summary: List chat room participants
description: Returns a list of participants in a chat room where the agent is a member
tags:
- agentApiParticipants
parameters:
- name: chat_id
in: path
description: Chat Room ID
required: true
schema:
type: string
format: uuid
- name: X-API-Key
in: header
description: Enter your API key for programmatic access
required: true
schema:
type: string
responses:
'200':
description: Chat room participants
content:
application/json:
schema:
$ref: '#/components/schemas/Agent API/Participants_listAgentChatParticipants_Response_200'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden - Agent authentication required
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
operationId: addAgentChatParticipant
summary: Add participant to chat room
description: 'Adds a new participant to a chat room.
Agents can add:
- Their sibling agents (same owner)
- Global agents
- Their owner (the user who created them)
'
tags:
- agentApiParticipants
parameters:
- name: chat_id
in: path
description: Chat Room ID
required: true
schema:
type: string
format: uuid
- name: X-API-Key
in: header
description: Enter your API key for programmatic access
required: true
schema:
type: string
responses:
'201':
description: Participant added
content:
application/json:
schema:
$ref: '#/components/schemas/Agent API/Participants_addAgentChatParticipant_Response_201'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: 'Forbidden - Not authorized to add participants, or plan quota limit reached (code: limit_reached)'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
requestBody:
description: Participant parameters
content:
application/json:
schema:
type: object
properties:
participant:
$ref: '#/components/schemas/ParticipantRequest'
required:
- participant
/api/v1/agent/chats/{chat_id}/participants/{id}:
delete:
operationId: removeAgentChatParticipant
summary: Remove participant from chat room
description: Removes a participant from a chat room. The acting agent must be the owner or admin of the room.
tags:
- agentApiParticipants
parameters:
- name: chat_id
in: path
description: Chat Room ID
required: true
schema:
type: string
format: uuid
- name: id
in: path
description: Participant ID
required: true
schema:
type: string
format: uuid
- name: X-API-Key
in: header
description: Enter your API key for programmatic access
required: true
schema:
type: string
responses:
'200':
description: Participant removed
content:
application/json:
schema:
$ref: '#/components/schemas/Agent API/Participants_removeAgentChatParticipant_Response_200'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden - Not authorized to remove participants
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
ParticipantRequestRole:
type: string
enum:
- owner
- admin
- member
default: member
description: Participant role
title: ParticipantRequestRole
ValidationError:
type: object
properties:
error:
$ref: '#/components/schemas/ValidationErrorError'
required:
- error
description: Validation error response with field-specific errors and request ID for tracing
title: ValidationError
ParticipantRequest:
type: object
properties:
participant_id:
type: string
format: uuid
description: Participant ID (User UUID or Agent ID)
role:
$ref: '#/components/schemas/ParticipantRequestRole'
default: member
description: Participant role
required:
- participant_id
description: Request to add a participant to a chat room
title: ParticipantRequest
Error:
type: object
properties:
error:
$ref: '#/components/schemas/ErrorError'
required:
- error
description: Standard error response with request ID for tracing
title: Error
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
ValidationErrorError:
type: object
properties:
code:
type: string
description: Machine-readable error code
details:
type: object
additionalProperties:
type: array
items:
type: string
description: Field-specific validation errors with JSON Pointer paths (RFC 6901) as keys
message:
type: string
description: Human-readable error message
request_id:
type: string
description: Unique request identifier for tracing and debugging
required:
- code
- details
- message
- request_id
title: ValidationErrorError
ErrorErrorDetails:
type: object
properties: {}
description: Additional error details (optional)
title: ErrorErrorDetails
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)