Skip to main content

Overview

The Plumi API allows you to programmatically:
  • Execute queries on connected databases
  • Manage database connections
  • Access query results
  • Integrate AI-powered data analysis

Base URL

All API requests should be made to your workspace URL:
https://your-workspace.plumi.ai/api

Authentication

All API endpoints require authentication using API keys.
curl -X GET "https://your-workspace.plumi.ai/api/connections" \
  -H "Authorization: Bearer YOUR_API_KEY"
See Authentication for details on obtaining and using API keys.

Response Format

All responses are returned as JSON:
{
  "success": true,
  "data": {
    // Response data
  }
}
Error responses include an error message:
{
  "success": false,
  "error": "Error message"
}

Rate Limits

API requests are rate limited based on your plan:
PlanRequests/minute
Free60
Professional300
EnterpriseUnlimited

Available Endpoints

Connections

  • GET /api/connections - List all database connections
  • POST /api/connections/test - Test a database connection

Queries

  • POST /api/query - Execute a SQL query
  • GET /api/query/history - Get query history

AI

  • POST /api/ai/generate - Generate SQL from natural language