KaiCalls Agency Profile API
The Agency Profile API from KaiCalls — 1 operation(s) for agency profile.
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/kaicalls-com:kaicalls-com-agency-profile-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: KaiCalls Public Agency Profile API
version: '2026-06-05'
description: Machine-readable surface for KaiCalls external developers and client agents.
servers:
- url: https://www.kaicalls.com/api
security:
- bearerAuth: []
tags:
- name: Agency Profile
paths:
/v1/agency-profile:
get:
summary: Read authorized agency profile
description: Verified agency scope and current canonical client membership apply. Private lists are bounded and never expose link tokens or connection secrets.
parameters:
- in: query
name: partnerId
schema:
type: string
format: uuid
- in: query
name: after
schema:
type: string
format: uuid
responses:
'200':
description: Scoped current state and page cursor where applicable.
'403':
description: Current membership or scope required.
'503':
description: Evidence unavailable; never reported as zero.
x-required-scopes: workspaces:read
tags:
- Agency Profile
operationId: getV1AgencyProfile
x-operation-id-source: derived
post:
summary: Manage agency profile using a strict reviewed command
description: IDs are in the body. Runtime refinements, current role, assignment and exact approval/hash/lease guards apply. Enrollment creation and commit require a stable Idempotency-Key. Installation run_scenarios also requires evals:write. Care requires sms:write and exact owner approval; preparation creates a draft, launch explicitly queues it. Provider-unknown outcomes require reconciliation. Configuration, testing, activation, billing and measured outcomes are distinct.
parameters:
- in: header
name: Idempotency-Key
schema:
type: string
maxLength: 150
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- type: object
properties:
action:
const: bootstrap
type: string
brand:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 120
logoUrl:
anyOf:
- type: string
format: uri
maxLength: 1000
- const: ''
type: string
default: ''
required:
- name
additionalProperties: false
support:
type: object
properties:
email:
type: string
format: email
maxLength: 254
ownerName:
type: string
minLength: 1
maxLength: 120
helpUrl:
anyOf:
- type: string
format: uri
maxLength: 1000
- const: ''
type: string
default: ''
coverage:
type: string
minLength: 1
maxLength: 500
required:
- email
- ownerName
- coverage
additionalProperties: false
required:
- action
- brand
- support
additionalProperties: false
- type: object
properties:
action:
const: update
type: string
partnerId:
type: string
format: uuid
expectedRevision:
type: string
format: uuid
brand:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 120
logoUrl:
anyOf:
- type: string
format: uri
maxLength: 1000
- const: ''
type: string
default: ''
required:
- name
additionalProperties: false
support:
type: object
properties:
email:
type: string
format: email
maxLength: 254
ownerName:
type: string
minLength: 1
maxLength: 120
helpUrl:
anyOf:
- type: string
format: uri
maxLength: 1000
- const: ''
type: string
default: ''
coverage:
type: string
minLength: 1
maxLength: 500
required:
- email
- ownerName
- coverage
additionalProperties: false
commercialMode:
type: string
enum:
- commission
- partner_billed
required:
- action
- partnerId
- expectedRevision
- brand
- support
- commercialMode
additionalProperties: false
- type: object
properties:
action:
const: invite
type: string
partnerId:
type: string
format: uuid
email:
type: string
format: email
maxLength: 254
role:
type: string
enum:
- admin
- operator
- reader
required:
- action
- partnerId
- email
- role
additionalProperties: false
- type: object
properties:
action:
const: accept_invite
type: string
partnerId:
type: string
format: uuid
token:
type: string
minLength: 1
maxLength: 200
required:
- action
- partnerId
- token
additionalProperties: false
- type: object
properties:
action:
const: revoke_invite
type: string
partnerId:
type: string
format: uuid
inviteId:
type: string
format: uuid
required:
- action
- partnerId
- inviteId
additionalProperties: false
- type: object
properties:
action:
const: assign
type: string
partnerId:
type: string
format: uuid
userId:
type: string
format: uuid
businessId:
type: string
format: uuid
businessRole:
type: string
enum:
- admin
- member
required:
- action
- partnerId
- userId
- businessId
- businessRole
additionalProperties: false
- type: object
properties:
action:
const: unassign
type: string
partnerId:
type: string
format: uuid
userId:
type: string
format: uuid
businessId:
type: string
format: uuid
required:
- action
- partnerId
- userId
- businessId
additionalProperties: false
- type: object
properties:
action:
const: revoke_member
type: string
partnerId:
type: string
format: uuid
userId:
type: string
format: uuid
required:
- action
- partnerId
- userId
additionalProperties: false
- type: object
properties:
action:
const: issue_key
type: string
partnerId:
type: string
format: uuid
name:
type: string
minLength: 1
maxLength: 100
scopes:
type: array
items:
type: string
minLength: 1
maxLength: 80
minItems: 1
maxItems: 25
required:
- action
- partnerId
- name
- scopes
additionalProperties: false
responses:
'200':
description: Recorded command receipt; read back current evidence.
'202':
description: Enrollment per-client receipt; inspect waiting and conflict states.
'400':
description: Invalid command.
'403':
description: Authority or approved owner revision required.
'409':
description: State changed or provider reconciliation required.
'503':
description: Dependency unavailable; durable operation retained.
x-required-scopes: workspaces:write
tags:
- Agency Profile
operationId: postV1AgencyProfile
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'KaiCalls API key. Per-operation scope requirements are published on each operation as `x-required-scopes` — a scope string, or a nested `{ allOf: [...] }` / `{ anyOf: [...] }` expression. An operation with no `x-required-scopes` requires a valid key but no particular scope.'
x-scopes:
- workspaces:read
- workspaces:write
- numbers:read
- numbers:write
- agents:read
- agents:write
- communication-runs:read
- communication-runs:write
- calls:read
- calls:write
- sms:read
- sms:write
- webhooks:read
- webhooks:write
- events:read
- events:replay
- lifecycle:write
- leads:read
- leads:write
- emails:read
- emails:write
- sdr:read
- sdr:write
- evals:read
- evals:write
- appointments:read
- appointments:write
- knowledge:read
- knowledge:write
- products:read
- products:write
- integrations:write
- approvals:write
- concierge:write
- billing:read
- billing:write
- call_evidence:read
- call_evidence:write
- support:write
sessionAuth:
type: apiKey
in: cookie
name: sb-access-token
description: Authenticated dashboard session cookie. Used by first-party flows that mint or manage API keys.