[Integration request]: Convex

[Mayank-saraswal]

What API or service would you like integrated?

Convex (convex.dev) — the reactive serverless backend platform for TypeScript apps

API documentation link

• https://docs.convex.dev/
• https://api.convex.dev/v1/openapi.json (Management API OpenAPI spec)
• https://docs.convex.dev/dashboard/deployments/management-api

What would you like to do with this integration?

I would like to implement a first-class Convex plugin for Corsair that lets AI agents manage Convex cloud resources programmatically through the Convex Management API: teams, projects, deployments, deploy keys, environment variables, and members.

I have claimed this integration on the Corsair OSS dashboard. The claimed API surface contains 19 operations, 0 webhooks, and 2 authentication methods.

Planned operations (based on the claimed surface and the Convex Management API)

Team and project management

• List teams
• List projects
• Create project
• Get project
• Delete project

Deployment management

• List deployments
• Create deployment
• Delete deployment
• Get deployment

Deploy keys

• Create deploy key
• List deploy keys

Environment variables

• List environment variables
• Set environment variable
• Delete environment variable

Members and organization

• List team members
• Invite member
• Remove member

This integration will allow Corsair agents to provision Convex projects and deployments, manage deploy keys and environment variables, and inspect team membership — all from within agent workflows.

I plan to implement this integration myself and open a focused pull request linked with Fixes #....

Do you need webhook support?

• Yes, I need webhook support for this integration

Webhook details (if applicable)

N/A — the claimed Convex integration exposes 0 webhooks. Convex deployments can be monitored through the corresponding get and list operations instead.

Additional context

Authentication

Convex supports two authentication modes that map to the claimed auth schemes:

1. Personal/team access token (API key) — sent as a Bearer token:

Authorization: Bearer <CONVEX_ACCESS_TOKEN>
Content-Type: application/json

2. OAuth 2.0 application token — for integrations managing projects on behalf of end users, also passed as a Bearer token.

Base API URL:

https://api.convex.dev/v1

Additional documentation

• Convex Management API
• Convex REST API reference
• Authentication docs

Implementation considerations

• Store the API key/token securely and never include it in logs, events, fixtures, or error messages.
• Implement all public inputs and outputs using Zod schemas.
• Route errors through the plugin's error-handlers.ts, including HTTP 429 rate-limit handling.
• Support pagination (limit/cursor) for list endpoints.
• Preserve useful response metadata such as IDs, deployment names, statuses, and timestamps.
• Avoid any, broad type assertions, dynamically generated code, eval, and new Function().
• Add corresponding tests for every implemented endpoint using real assertions.
• Include a working demo video in the pull request before requesting human review.
• Keep the pull request limited to one plugin and follow the plugin contribution rules in .github/PLUGIN_PR_RULES.md.