Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/cqnce-app:cqnce-app-projects-api"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.
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: 3.2.0
info:
title: cQnce Projects API
description: 'Authorization-request routing and agent-management API for the cQnce platform.
## Authentication
| Scheme | Header | Used by |
|---|---|---|
| Bearer JWT (tenant) | `Authorization: Bearer ` | Dashboard / admin routes |
| Bearer JWT (agent) | `Authorization: Bearer ` | Agent mobile app routes |
| API Key | `x-api-key: ` | Server-to-server request submission |'
version: 1.0.0
contact:
name: cQnce Support
servers:
- url: https://api.cqnce.app
description: Production
tags:
- name: Projects
description: Project management (requires tenant JWT)
paths:
/v1/projects:
get:
tags:
- Projects
summary: List projects
description: Returns all projects belonging to the authenticated tenant.
operationId: listProjects
security:
- tenantJWT: []
responses:
'200':
description: List of projects
content:
application/json:
schema:
type: object
properties:
projects:
type: array
items:
$ref: '#/components/schemas/Project'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
tags:
- Projects
summary: Create project
operationId: createProject
security:
- tenantJWT: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
type: string
example: Production Auth
description:
type: string
tags:
type: array
items:
type: string
example:
- prod
- critical
payloadSchemaType:
type: string
enum:
- DYNAMIC
- SAMPLE
- JSON_SCHEMA
default: DYNAMIC
payloadSchema:
description: JSON Schema or sample object (when payloadSchemaType is not DYNAMIC)
metadataSchemaType:
type: string
enum:
- DYNAMIC
- SAMPLE
- JSON_SCHEMA
default: DYNAMIC
metadataSchema:
description: JSON Schema or sample object (when metadataSchemaType is not DYNAMIC)
defaultAction:
type:
- string
- 'null'
enum:
- APPROVE
- REJECT
- null
description: Action when no routing rule matches
responses:
'201':
description: Project created
content:
application/json:
schema:
type: object
properties:
project:
$ref: '#/components/schemas/Project'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}:
get:
tags:
- Projects
summary: Get project
description: Returns a single project including its routing rules and callbacks.
operationId: getProject
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Project details
content:
application/json:
schema:
type: object
properties:
project:
$ref: '#/components/schemas/Project'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
put:
tags:
- Projects
summary: Update project
operationId: updateProject
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
description:
type: string
tags:
type: array
items:
type: string
payloadSchemaType:
type: string
enum:
- DYNAMIC
- SAMPLE
- JSON_SCHEMA
payloadSchema: {}
metadataSchemaType:
type: string
enum:
- DYNAMIC
- SAMPLE
- JSON_SCHEMA
metadataSchema: {}
defaultAction:
type:
- string
- 'null'
enum:
- APPROVE
- REJECT
- null
responses:
'200':
description: Project updated
content:
application/json:
schema:
type: object
properties:
project:
$ref: '#/components/schemas/Project'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
delete:
tags:
- Projects
summary: Delete project
description: Deletes the project and all its associated routing rules, requests, responses, and logs.
operationId: deleteProject
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Project deleted
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}/regenerate-api-key:
post:
tags:
- Projects
summary: Regenerate project API key
operationId: regenerateProjectApiKey
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: New API key generated
content:
application/json:
schema:
type: object
properties:
project:
$ref: '#/components/schemas/Project'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}/test-rules:
post:
tags:
- Projects
summary: Test routing rules
description: Simulates a request against the project's routing rules and returns which rule would match and which agents would be notified.
operationId: testProjectRules
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- payload
properties:
payload:
type: object
description: Request payload to test
example:
action: transfer
amount: 1000
metadata:
type: object
description: Optional metadata
responses:
'200':
description: Rule evaluation result
content:
application/json:
schema:
type: object
properties:
matchedRule:
$ref: '#/components/schemas/RoutingRule'
agents:
type: array
items:
$ref: '#/components/schemas/Agent'
reason:
type: string
defaultAction:
type:
- string
- 'null'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}/icon:
patch:
tags:
- Projects
summary: Update project icon
description: Uploads a base64-encoded image as the project icon.
operationId: updateProjectIcon
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- iconUrl
properties:
iconUrl:
type: string
description: Base64 data URL of the new icon (data:image/...)
responses:
'200':
description: Icon updated
content:
application/json:
schema:
type: object
properties:
project:
$ref: '#/components/schemas/Project'
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}/clients:
get:
tags:
- Projects
summary: List client credentials
description: Returns all client credential records for the project. The `clientSecret` is never returned after creation.
operationId: listProjectClients
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Project ID
responses:
'200':
description: Client credential list
content:
application/json:
schema:
type: object
properties:
clients:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
name:
type:
- string
- 'null'
clientId:
type: string
example: cid_abc123
isActive:
type: boolean
createdAt:
type: string
format: date-time
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
tags:
- Projects
summary: Create client credentials
description: Generates a new `clientId` / `clientSecret` pair for server-to-server authentication. The `clientSecret` is returned **only once** and must be stored securely.
operationId: createProjectClient
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Project ID
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
description: Optional human-friendly label
responses:
'201':
description: Credentials created – clientSecret shown once
content:
application/json:
schema:
type: object
properties:
client:
type: object
properties:
id:
type: string
format: uuid
name:
type:
- string
- 'null'
clientId:
type: string
example: cid_abc123
isActive:
type: boolean
createdAt:
type: string
format: date-time
clientSecret:
type: string
description: Plain-text secret – store this value now, it is never retrievable again
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}/clients/{clientRecordId}:
delete:
tags:
- Projects
summary: Delete client credentials
operationId: deleteProjectClient
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Project ID
- name: clientRecordId
in: path
required: true
schema:
type: string
format: uuid
description: Client record ID
responses:
'200':
description: Client credential deleted
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project or client not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}/widget-integrations:
get:
tags:
- Projects
summary: List widget integrations
operationId: listWidgetIntegrations
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Project ID
responses:
'200':
description: Widget integration list
content:
application/json:
schema:
type: object
properties:
integrations:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
integrationKey:
type: string
example: wik_abc123
allowedOrigins:
type: array
items:
type: string
uiConfig:
type:
- object
- 'null'
isActive:
type: boolean
createdAt:
type: string
format: date-time
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
tags:
- Projects
summary: Create widget integration
description: Creates a new widget integration and an associated agent team. The `signingSecret` is returned **only once**.
operationId: createWidgetIntegration
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Project ID
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
properties:
name:
type: string
example: My Widget
allowedOrigins:
type: array
items:
type: string
example:
- https://example.com
uiConfig:
type: object
description: Optional UI configuration for the widget
responses:
'201':
description: Widget integration created – signingSecret shown once
content:
application/json:
schema:
type: object
properties:
integration:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
integrationKey:
type: string
allowedOrigins:
type: array
items:
type: string
uiConfig:
type:
- object
- 'null'
isActive:
type: boolean
createdAt:
type: string
format: date-time
signingSecret:
type: string
description: Plain-text signing secret – store this value now
'400':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Integration or team name already exists in this tenant
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}/widget-integrations/{integrationId}:
delete:
tags:
- Projects
summary: Delete widget integration
operationId: deleteWidgetIntegration
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Project ID
- name: integrationId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: Widget integration deleted
content:
application/json:
schema:
type: object
properties:
message:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project or integration not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/projects/{id}/widget-integrations/{integrationId}/rotate-secret:
post:
tags:
- Projects
summary: Rotate widget integration signing secret
description: Generates a new signing secret for the integration. The new secret is returned **only once**.
operationId: rotateWidgetIntegrationSecret
security:
- tenantJWT: []
parameters:
- name: id
in: path
required: true
schema:
type: string
format: uuid
description: Project ID
- name: integrationId
in: path
required: true
schema:
type: string
format: uuid
responses:
'200':
description: New signing secret generated
content:
application/json:
schema:
type: object
properties:
integration:
type: object
signingSecret:
type: string
description: New plain-text signing secret – store this value now
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Project or integration not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
RoutingRule:
type: object
properties:
id:
type: string
format: uuid
projectId:
type: string
format: uuid
name:
type:
- string
- 'null'
mode:
type: string
enum:
- PARALLEL
- SERIAL
- MAJORITY
- CHAIN
agentIds:
type: array
items:
type: string
format: uuid
teamIds:
type: array
items:
type: string
format: uuid
timeoutMs:
type:
- integer
- 'null'
quorum:
type:
- integer
- 'null'
tagFilter:
type:
- string
- 'null'
priority:
type: integer
filterExpression:
description: JSONLogic-compatible filter expression
requireStrongAuth:
type: boolean
serialRoundRobin:
type: boolean
description: 'SERIAL mode only: rotate the first assignee at each new request to distribute load across agents.'
rejectReasonRequired:
type: boolean
description: When true, agents must provide a rejection reason when submitting REJECTED decisions.
rejectReasonOptions:
type: array
items:
type: string
description: Reusable predefined rejection reasons available to agents for this rule.
defaultRejectReason:
type:
- string
- 'null'
description: Default rejection reason preselected for agents; must be one of rejectReasonOptions.
allowLateResponse:
type: boolean
description: When true, agent responses submitted after the request has expired are accepted and resolve the request.
createdAt:
type: string
format: date-time
Error:
type: object
properties:
error:
type: string
example: Validation failed
details:
type: array
items:
type: object
Project:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
description:
type:
- string
- 'null'
tags:
type: array
items:
type: string
apiKey:
type: string
tenantId:
type: string
format: uuid
payloadSchemaType:
type: string
enum:
- DYNAMIC
- SAMPLE
- JSON_SCHEMA
payloadSchema: {}
metadataSchemaType:
type: string
enum:
- DYNAMIC
- SAMPLE
- JSON_SCHEMA
metadataSchema: {}
defaultAction:
type:
- string
- 'null'
enum:
- APPROVE
- REJECT
- null
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
Agent:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
surname:
type:
- string
- 'null'
email:
type:
- string
- 'null'
format: email
phone:
type: string
online:
type: boolean
tenantId:
type:
- string
- 'null'
format: uuid
createdAt:
type: string
format: date-time
securitySchemes:
tenantJWT:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT issued on tenant login (`POST /v1/auth/login`)
agentJWT:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT issued on agent login/register (`POST /v1/auth/agent/login` or `/register`)
projectApiKey:
type: apiKey
in: header
name: x-api-key
description: Per-project API key used for server-to-server request submission