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/corebee-ai:corebee-ai-labels-api"
All apis
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.
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: Corebee Ai Labels API
version: 1.0.0
contact:
name: Corebee
email: support@corebee.ai
description: 'Operations tagged labels across 2 of this provider''s published API definitions: corebee-ai-openapi.json, corebee-ai-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://corebee.ai/api/v1
description: Production
security:
- bearerAuth: []
tags:
- name: Labels
description: Conversation labels
paths:
/labels:
get:
summary: List labels
operationId: list_labels
tags:
- Labels
parameters:
- name: limit
in: query
required: false
description: Page size (max 100, default 25).
schema:
type: integer
minimum: 1
maximum: 100
default: 25
- name: offset
in: query
required: false
description: Number of records to skip.
schema:
type: integer
minimum: 0
default: 0
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
required:
- data
properties:
data:
type: array
items:
$ref: '#/components/schemas/Label'
meta:
$ref: '#/components/schemas/Pagination'
'401':
description: Invalid or missing credential
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
summary: Create a label
operationId: create_label
tags:
- Labels
description: Requires title.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/LabelCreate'
example:
title: Billing
color: '#2E7D6B'
responses:
'201':
description: Created
content:
application/json:
schema:
type: object
required:
- data
properties:
data:
$ref: '#/components/schemas/Label'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credential
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://corebee.ai/api/v1
description: Production
/labels/{id}:
get:
summary: Get a label
operationId: get_label
tags:
- Labels
parameters:
- name: id
in: path
required: true
description: Resource UUID.
schema:
type: string
format: uuid
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
required:
- data
properties:
data:
$ref: '#/components/schemas/Label'
'401':
description: Invalid or missing credential
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
put:
summary: Update a label
operationId: update_label
tags:
- Labels
parameters:
- name: id
in: path
required: true
description: Resource UUID.
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/LabelCreate'
example:
title: Billing & Plans
responses:
'200':
description: Updated
content:
application/json:
schema:
type: object
required:
- data
properties:
data:
$ref: '#/components/schemas/Label'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid or missing credential
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
delete:
summary: Delete a label
operationId: delete_label
tags:
- Labels
parameters:
- name: id
in: path
required: true
description: Resource UUID.
schema:
type: string
format: uuid
responses:
'200':
description: Deleted
'401':
description: Invalid or missing credential
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
servers:
- url: https://corebee.ai/api/v1
description: Production
components:
schemas:
LabelCreate:
type: object
required:
- title
properties:
title:
type: string
description:
type: string
color:
type: string
example: '#2E7D6B'
show_on_sidebar:
type: boolean
default: true
Label:
type: object
properties:
id:
type: string
format: uuid
org_id:
type: string
format: uuid
title:
type: string
example: Billing
description:
type: string
nullable: true
color:
type: string
nullable: true
example: '#2E7D6B'
show_on_sidebar:
type: boolean
default: true
created_at:
type: string
format: date-time
Error:
type: object
description: Error envelope. Fields are also mirrored flat at the top level (code, message, status) for backwards compatibility.
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
example: validation_error
message:
type: string
example: content is required
details:
type: object
additionalProperties: true
nullable: true
code:
type: string
message:
type: string
status:
type: integer
example: 400
Pagination:
type: object
required:
- total
- limit
- offset
properties:
total:
type: integer
description: Total matching records.
example: 142
limit:
type: integer
example: 25
offset:
type: integer
example: 0
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Org-scoped API key, or an OAuth 2.1 access token (authorization_code + PKCE; see /.well-known/oauth-protected-resource). An API key is minted in the Corebee dashboard under Settings, Developers, API keys, and the SCOPES it carries are chosen at that moment and cannot be widened afterwards, mint a new key instead. Every voice/bridge operation needs the voice:bridge scope. A key without the scope and a key whose organization does not own the number both answer 403 FORBIDDEN; the message distinguishes them ("Missing required scope: voice:bridge" vs "from_number is not a phone number owned by this organization").'
externalDocs:
description: Machine-readable catalogue of every error code this API emits.
url: https://corebee.ai/api/v1/error-codes.json
x-refined-from:
- corebee-ai-openapi.json
- corebee-ai-openapi.yml
x-mcp:
endpoint: https://corebee.ai/api/v1/mcp/stream
server_card: https://corebee.ai/.well-known/mcp/server-card.json
x-rate-limit:
requests: 100
window_seconds: 60
scope: api_key
headers:
- Retry-After
- X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset
headers_on: 429 only
per_org:
- operation: PATCH /voice/bridge/settings
requests: 10
window_seconds: 60
- operation: PATCH /voice/bridge/numbers
requests: 30
window_seconds: 60
counts: a voice_id, not null
- operation: GET /voice/bridge/voices?set=all + GET /voice/bridge/voices/{voice_id}
requests: 60
window_seconds: 60
counts: voices off the recommended list
- operation: GET /voice/bridge/voices/{voice_id}/preview
requests: 30
window_seconds: 60
counts: voices off the recommended list
x-error-codes: https://corebee.ai/api/v1/error-codes.json