Convex is a serverless backend platform that provides a real-time database, cloud functions, and infrastructure for building modern web and mobile applications. It offers a TypeScript-first developer experience with reactive queries, transactional mutations, and integrated file storage, all accessible through a suite of HTTP, management, and deployment APIs alongside JavaScript and server SDKs for full-stack application development. The platform is SOC 2 Type II, HIPAA, and GDPR compliant.
Convex publishes 15 API contracts indexed on the APIs.io network, including Sync Protocol, Actions API, Deployments API, and 12 more. Tagged areas include Backend, Database, Functions, Real-Time, and Reactive.
The Convex catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 5 Spectral governance rulesets.
Convex’s developer surface includes authentication, developer portal, documentation, engineering blog, GitHub presence, and 21 more developer resources.
51.5/100developing▬ flatAgent38/100agent readyFront door AI4/6
moderate
Heartbeat61/100
slowing
saas
Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/convex/"><img src="https://apis.io/badge/convex/card.svg" alt="Convex on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Request/Response Examples+7 pts — share of operations carrying request/response examples; else an Examples / Code Samples link
Delegated User Identity+6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Pagination+5 pts — share of collection GETs (an array, or one wrapped in data/items/results ...) that declare a page/limit/offset/cursor parameter, a Link header or a next/cursor field; na with no collection GETs
6 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
The Convex Sync Protocol is the bidirectional WebSocket protocol spoken between Convex client SDKs and the sync worker of a Convex deployment. Clients open a single WebSocket co...
The Convex JavaScript SDK is a collection of TypeScript/JavaScript packages for building applications on the Convex backend platform. It includes convex/server for defining back...
The Convex Server SDK (convex/server) is the TypeScript library for defining backend logic deployed on Convex. It provides primitives for writing query functions for read-only d...
Execute action functions for general-purpose server-side operations, including calling external services, performing non-transactional work, and orchestrating other functions.
Create, list, retrieve, update, and delete Convex cloud and local deployments. Deployments are the runtime environments where Convex backend functions execute.
Execute any deployed function by its identifier using the unified run endpoint, which accepts the function type implicitly based on the deployed function definition.
Create, list, retrieve, and delete Convex projects within a team. Projects group deployments and serve as the top-level organizational unit for Convex applications.
Execute read-only query functions deployed on the Convex backend. Queries run in a transactional, reactive context and return data from the Convex database.
Manage environment variables for a Convex deployment. Environment variables are key-value pairs accessible to backend functions at runtime via process.env. Changes to environmen...
AsyncAPI description of the Convex WebSocket sync protocol used between Convex client SDKs (browser/Node/React/React Native) and a Convex deployment's sync worker. The client op...
aid: convex
url: https://raw.githubusercontent.com/api-evangelist/convex/refs/heads/main/apis.yml
name: Convex
kind: company
description: Convex is a serverless backend platform that provides a real-time database, cloud functions, and infrastructure
for building modern web and mobile applications. It offers a TypeScript-first developer experience with reactive queries,
transactional mutations, and integrated file storage, all accessible through a suite of HTTP, management, and deployment
APIs alongside JavaScript and server SDKs for full-stack application development. The platform is SOC 2 Type II, HIPAA,
and GDPR compliant.
deliveryModel:
model: saas
license_evidence:
not_product:
- get-convex/convex-js
open_source: unknown
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: low
source:
- openapi
- pricing
- repository-not-product
generated: '2026-09-25'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
gated: none
gated_source:
- onboarding
label: Freemium · Self-serve signup
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-06'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/convex.png
x-docs-platform: docusaurus
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-09-24
x-docs-hosting: netlify
tags:
- Backend
- Database
- Functions
- Real-Time
- Reactive
- Serverless
- TypeScript
created: '2026-03-21'
modified: '2026-05-29'
specificationVersion: '0.23'
apis:
- aid: convex:sync-protocol
name: Convex Sync Protocol
tags:
- Real-Time
- Reactive
- Sync
- WebSocket
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
baseURL: wss://{deployment-name}.convex.cloud/api/{clientVersion}/sync
humanURL: https://docs.convex.dev/understanding/
properties:
- url: https://docs.convex.dev/understanding/
type: Documentation
- url: https://github.com/get-convex/convex-js/blob/main/src/browser/sync/protocol.ts
type: SourceCode
- url: asyncapi/convex-asyncapi.yml
type: AsyncAPI
description: The Convex Sync Protocol is the bidirectional WebSocket protocol spoken between Convex client SDKs and the
sync worker of a Convex deployment. Clients open a single WebSocket connection to wss://{deployment-name}.convex.cloud/api/{clientVersion}/sync
and exchange JSON envelopes (discriminated by a `type` field) to authenticate, subscribe to reactive query sets, invoke
mutations and actions, and receive query transitions, function responses, auth errors, fatal errors, and pings. The protocol
is implemented in the open source convex-js client (`src/browser/sync/protocol.ts`).
x-features:
- Connect / Authenticate session handshake with reconnection state
- ModifyQuerySet subscriptions with Add and Remove modifications
- Mutation and Action request/response with requestId correlation
- Transition and TransitionChunk messages carrying QueryUpdated, QueryFailed, and QueryRemoved state modifications
- AuthError, FatalError, and Ping server-pushed messages
- Client-emitted Event telemetry frames (e.g. ClientConnect)
x-useCases:
- Building custom Convex clients in languages other than JavaScript
- Auditing and governing the realtime traffic of Convex deployments
- Implementing observability and replay tooling for sync sessions
- Documenting Convex's reactive backend for security and compliance review
- aid: convex:javascript-sdk
name: Convex JavaScript SDK
tags:
- Client Library
- JavaScript
- SDK
- TypeScript
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
humanURL: https://docs.convex.dev/api/
properties:
- url: https://docs.convex.dev/api/
type: Documentation
- url: https://www.npmjs.com/package/convex
type: Package
description: The Convex JavaScript SDK is a collection of TypeScript/JavaScript packages for building applications on the
Convex backend platform. It includes convex/server for defining backend functions and database schemas, convex/react for
React hooks and the ConvexReactClient, convex/browser for the ConvexHttpClient in non-React browser environments, convex/values
for working with Convex-stored data types, and framework integrations for Next.js, React Native, and other environments.
x-features:
- ConvexReactClient with reactive useQuery, useMutation hooks
- ConvexHttpClient for non-React JavaScript runtimes
- Strongly typed client generated from project schema
- Authentication helpers for Clerk, Auth0, and custom providers
- Framework integrations for Next.js, React Native, and Svelte
x-useCases:
- Building real-time React applications backed by Convex
- Embedding Convex queries in Next.js server components
- Server-rendered apps that read Convex data on the server
- Cross-platform mobile apps using React Native and Convex
- aid: convex:server-sdk
name: Convex Server SDK
tags:
- Backend
- Database
- Serverless Functions
- TypeScript
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
humanURL: https://docs.convex.dev/functions
properties:
- url: https://docs.convex.dev/functions
type: Documentation
- url: https://docs.convex.dev/database/schemas
type: Documentation
description: The Convex Server SDK (convex/server) is the TypeScript library for defining backend logic deployed on Convex.
It provides primitives for writing query functions for read-only database access, mutation functions for transactional
writes, and action functions for general-purpose server-side operations including calling external services. The SDK supports
schema definition, full-text search indexes, vector search indexes, file storage, scheduled functions, cron jobs, and
HTTP routing via the HttpRouter class.
x-features:
- query, mutation, and action function primitives
- defineSchema and defineTable for typed database modeling
- Full-text and vector search indexes
- Cron jobs and scheduled function execution
- HttpRouter for custom HTTP endpoints
- File storage with signed URL generation
x-useCases:
- Authoring Convex backend functions in TypeScript
- Modeling reactive database schemas with type safety
- Implementing AI workflows with vector search
- Scheduling recurring background work with cron jobs
- Building HTTP webhook handlers inside Convex deployments
- aid: convex:convex-actions-api
name: Convex Actions API
description: Execute action functions for general-purpose server-side operations, including calling external services, performing
non-transactional work, and orchestrating other functions.
humanURL: https://docs.convex.dev/http-api/
baseURL: https://{deployment-name}.convex.cloud
tags:
- Actions
properties:
- type: OpenAPI
url: openapi/convex-actions-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-deployments-api
name: Convex Deployments API
description: Create, list, retrieve, update, and delete Convex cloud and local deployments. Deployments are the runtime
environments where Convex backend functions execute.
humanURL: https://docs.convex.dev/http-api/
baseURL: https://{deployment-name}.convex.cloud
tags:
- Deployment
tags_raw:
- Deployments
properties:
- type: OpenAPI
url: openapi/convex-deployments-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-functions-api
name: Convex Functions API
description: Execute any deployed function by its identifier using the unified run endpoint, which accepts the function
type implicitly based on the deployed function definition.
humanURL: https://docs.convex.dev/http-api/
baseURL: https://{deployment-name}.convex.cloud
tags:
- Functions
properties:
- type: OpenAPI
url: openapi/convex-functions-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-mutations-api
name: Convex Mutations API
description: Execute mutation functions that perform transactional writes to the Convex database. Mutations are strongly
consistent and run with ACID guarantees.
humanURL: https://docs.convex.dev/http-api/
baseURL: https://{deployment-name}.convex.cloud
tags:
- Mutations
properties:
- type: OpenAPI
url: openapi/convex-mutations-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-projects-api
name: Convex Projects API
description: Create, list, retrieve, and delete Convex projects within a team. Projects group deployments and serve as the
top-level organizational unit for Convex applications.
humanURL: https://docs.convex.dev/http-api/
baseURL: https://{deployment-name}.convex.cloud
tags:
- Project
tags_raw:
- Projects
properties:
- type: OpenAPI
url: openapi/convex-projects-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-queries-api
name: Convex Queries API
description: Execute read-only query functions deployed on the Convex backend. Queries run in a transactional, reactive
context and return data from the Convex database.
humanURL: https://docs.convex.dev/http-api/
baseURL: https://{deployment-name}.convex.cloud
tags:
- Query
tags_raw:
- Queries
properties:
- type: OpenAPI
url: openapi/convex-queries-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-teams-api
name: Convex Teams API
description: Manage Convex teams, team members, and team-level access tokens. Teams are the billing and administrative unit
that owns projects.
humanURL: https://docs.convex.dev/http-api/
baseURL: https://{deployment-name}.convex.cloud
tags:
- Team
tags_raw:
- Teams
properties:
- type: OpenAPI
url: openapi/convex-teams-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-access-tokens-api
name: Convex Access Tokens API
description: Create and manage Team Access Tokens used for authenticating Management API requests on behalf of a team.
humanURL: https://docs.convex.dev/understanding/
baseURL: wss://{deployment-name}.convex.cloud/api/{clientVersion}/sync
tags:
- Access Tokens
properties:
- type: OpenAPI
url: openapi/convex-access-tokens-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-custom-domains-api
name: Convex Custom Domains API
description: Configure custom domain names for Convex deployments. Supports both convexCloud (function API) and convexSite
(HTTP actions) request destinations.
humanURL: https://docs.convex.dev/understanding/
baseURL: wss://{deployment-name}.convex.cloud/api/{clientVersion}/sync
tags:
- Custom Domains
properties:
- type: OpenAPI
url: openapi/convex-custom-domains-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-environment-variables-api
name: Convex Environment Variables API
description: Manage environment variables for a Convex deployment. Environment variables are key-value pairs accessible
to backend functions at runtime via process.env. Changes to environment variables take effect after the next deployment
push.
humanURL: https://docs.convex.dev/understanding/
baseURL: wss://{deployment-name}.convex.cloud/api/{clientVersion}/sync
tags:
- Environment Variables
properties:
- type: OpenAPI
url: openapi/convex-environment-variables-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-custom-roles-api
name: Convex Custom Roles API
description: The Custom Roles API from Convex — 4 operation(s) for custom roles.
humanURL: https://docs.convex.dev/understanding/
baseURL: wss://{deployment-name}.convex.cloud/api/{clientVersion}/sync
tags:
- Custom Roles
properties:
- type: OpenAPI
url: openapi/convex-custom-roles-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
- aid: convex:convex-deploy-keys-api
name: Convex Deploy Keys API
description: Create, list, and delete deploy keys
humanURL: https://docs.convex.dev/understanding/
baseURL: wss://{deployment-name}.convex.cloud/api/{clientVersion}/sync
tags:
- Deploy Keys
properties:
- type: OpenAPI
url: openapi/convex-deploy-keys-api-openapi.yml
- type: Documentation
url: https://docs.convex.dev/http-api/
- type: Documentation
url: https://docs.convex.dev/management-api
- type: Documentation
url: https://docs.convex.dev/deployment-platform-api
common:
- type: Plans
url: plans/convex-plans-pricing.yml
- type: RateLimits
url: rate-limits/convex-rate-limits.yml
- type: FinOps
url: finops/convex-finops.yml
- type: CapabilityMap
url: capabilities/convex-capability-edges.yml
name: Convex Business Capability Map
- type: PostmanWorkspace
url: https://www.postman.com/kinlaneapi/convex/overview
- type: AgenticAccess
url: agentic-access/convex-agentic-access.yml
- type: TrustCenter
url: security/convex-trust-center.yml
- type: VulnerabilityDisclosure
url: security/convex-vulnerability-disclosure.yml
- type: DomainSecurity
url: security/convex-domain-security.yml
- type: Authentication
url: authentication/convex-authentication.yml
- type: LinkedIn
url: https://www.linkedin.com/company/convex-dev
- type: Portal
url: https://www.convex.dev/developers
- type: Documentation
url: https://docs.convex.dev/
- type: Website
url: https://www.convex.dev
- type: Login
url: https://dashboard.convex.dev/
- type: Blog
url: https://stack.convex.dev/
- type: GitHub
url: https://github.com/get-convex
- type: Discord
url: https://convex.dev/community
- type: TermsOfService
url: https://www.convex.dev/legal/terms
- type: PrivacyPolicy
url: https://www.convex.dev/legal/privacy
- type: JSONSchema
url: json-schema/convex-function-schema.json
- type: JSONSchema
url: json-schema/convex-deployment-schema.json
- type: JSONLD
url: json-ld/convex-context.jsonld
- type: Vocabulary
url: vocabulary/convex-vocabulary.yml
- type: Integrations
url: https://www.convex.dev/partners
- name: MCP Server
url: https://stack.convex.dev/convex-mcp-server
type: MCPServer
- type: LlmsText
url: https://docs.convex.dev/llms.txt
integrations:
- name: Apply to join our partner network
maintainers:
- FN: API Evangelist
email: info@apievangelist.com
Convex API — frequently asked questions
Does Convex have an API?
Yes. APIs.io lists 15 APIs from Convex, including Convex Sync Protocol, Convex JavaScript SDK and Convex Server SDK, and 12 more.
Is there an OpenAPI specification for the Convex API?
Yes. APIs.io indexes 12 OpenAPI specifications for Convex, each linked for download from this page.
How do I authenticate with the Convex API?
Convex uses bearer-token authentication (apiKey/http · 2 schemes). The details are profiled on APIs.io as Convex Authentication.
How much does the Convex API cost?
Convex publishes its prices; its Free & Starter plan is Free or $0/month and pay as you go as of 2026-10-28. APIs.io lists 3 pricing plans for Convex, with each plan's price, limits and inclusions under Pricing on this page.
Does Convex have an MCP server?
Yes. APIs.io lists 2 MCP servers for Convex: Remote MCP server at mcp.convex.dev over HTTP; 4 tools listed.
Is the Convex API ready for AI agents?
Convex has a Kin Score of 51.5 out of 100 (developing) and an Agent Readiness score of 37.8 (agent-ready), scored by API Evangelist on 2026-11-06.
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.