KaiCalls Agency Installations API
The Agency Installations API from KaiCalls — 1 operation(s) for agency installations.
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-installations-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 Installations 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 Installations
paths:
/v1/agency-installations:
get:
summary: Read authorized agency installations
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 Installations
operationId: getV1AgencyInstallations
x-operation-id-source: derived
post:
summary: Manage agency installations 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:
type: string
enum:
- preview_route_receipt
- approve_route_receipt
partnerId:
type: string
format: uuid
installationId:
type: string
format: uuid
expectedRevision:
type: string
pattern: ^[a-f0-9]{64}$
fingerprint:
type: string
pattern: ^[a-f0-9]{64}$
required:
- action
- partnerId
- installationId
- expectedRevision
additionalProperties: false
- type: object
properties:
action:
type: string
enum:
- preview_handoff
- approve_handoff
partnerId:
type: string
format: uuid
installationId:
type: string
format: uuid
expectedRevision:
type: string
pattern: ^[a-f0-9]{64}$
fingerprint:
type: string
pattern: ^[a-f0-9]{64}$
required:
- action
- partnerId
- installationId
- expectedRevision
additionalProperties: false
- type: object
properties:
action:
const: resolve_update
type: string
partnerId:
type: string
format: uuid
installationId:
type: string
format: uuid
expectedRevision:
type: string
pattern: ^[a-f0-9]{64}$
updateId:
type: string
format: uuid
fingerprint:
type: string
pattern: ^[a-f0-9]{64}$
choices:
type: object
additionalProperties:
type: string
enum:
- keep_client
- use_package
required:
- action
- partnerId
- installationId
- expectedRevision
- updateId
- fingerprint
- choices
additionalProperties: false
- type: object
properties:
action:
const: run_scenarios
type: string
partnerId:
type: string
format: uuid
installationId:
type: string
format: uuid
expectedRevision:
type: string
pattern: ^[a-f0-9]{64}$
requestId:
type: string
format: uuid
required:
- action
- partnerId
- installationId
- expectedRevision
- requestId
additionalProperties: false
- type: object
properties:
action:
const: owner_preview
type: string
partnerId:
type: string
format: uuid
businessId:
type: string
format: uuid
sessionId:
type: string
format: uuid
required:
- action
- partnerId
- businessId
- sessionId
additionalProperties: false
- type: object
properties:
action:
const: approve
type: string
partnerId:
type: string
format: uuid
businessId:
type: string
format: uuid
sessionId:
type: string
format: uuid
subject:
type: string
enum:
- facts
- script
subjectHash:
type: string
pattern: ^[a-f0-9]{64}$
required:
- action
- partnerId
- businessId
- sessionId
- subject
- subjectHash
additionalProperties: false
- type: object
properties:
action:
const: revoke_approval
type: string
partnerId:
type: string
format: uuid
businessId:
type: string
format: uuid
approvalId:
type: string
format: uuid
required:
- action
- partnerId
- businessId
- approvalId
additionalProperties: false
- type: object
properties:
action:
type: string
enum:
- pause
- retry
- export
- preview_offboard
- offboard
partnerId:
type: string
format: uuid
installationId:
type: string
format: uuid
expectedRevision:
type: string
pattern: ^[a-f0-9]{64}$
fingerprint:
type: string
pattern: ^[a-f0-9]{64}$
accepted:
const: true
type: boolean
required:
- action
- partnerId
- installationId
- expectedRevision
additionalProperties: false
- type: object
properties:
action:
const: preview_update
type: string
partnerId:
type: string
format: uuid
installationId:
type: string
format: uuid
expectedRevision:
type: string
pattern: ^[a-f0-9]{64}$
offerVersionId:
type: string
format: uuid
rollbackRevision:
type: string
pattern: ^[a-f0-9]{64}$
required:
- action
- partnerId
- installationId
- expectedRevision
additionalProperties: false
- type: object
properties:
action:
type: string
enum:
- approve_update
- apply_update
partnerId:
type: string
format: uuid
installationId:
type: string
format: uuid
expectedRevision:
type: string
pattern: ^[a-f0-9]{64}$
updateId:
type: string
format: uuid
fingerprint:
type: string
pattern: ^[a-f0-9]{64}$
required:
- action
- partnerId
- installationId
- expectedRevision
- updateId
- fingerprint
additionalProperties: false
- type: object
properties:
action:
const: opt_into_canary
type: string
partnerId:
type: string
format: uuid
installationId:
type: string
format: uuid
expectedRevision:
type: string
pattern: ^[a-f0-9]{64}$
accepted:
const: true
type: boolean
required:
- action
- partnerId
- installationId
- expectedRevision
- accepted
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:
allOf:
- workspaces:write
- agents:write
tags:
- Agency Installations
operationId: postV1AgencyInstallations
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.