Overview
The Fluar API lets you fully manage projects, columns, rows, cells, and processing from external applications and AI agents. The v3 API provides comprehensive CRUD operations for all resources, while the v2 API remains available for backward compatibility.
Base URL
API Versions
| Version | Status | Description |
|---|
| v3 | Current | Full CRUD for projects, columns, rows, cells, views, and processing |
| v2 | Stable | Insert and update rows |
v3 Endpoints
Projects
GET /v3/{teamSlug}/projects - List all projectsGET /v3/{teamSlug}/{projectId} - Get project with columnsPATCH /v3/{teamSlug}/{projectId} - Update project settings
Columns
GET /v3/{teamSlug}/{projectId}/columns - List columns (full config)GET /v3/{teamSlug}/{projectId}/columns/templates - List available column templatesPOST /v3/{teamSlug}/{projectId}/columns - Create column from templatePATCH /v3/{teamSlug}/{projectId}/columns/{columnId} - Update column (with autofix)DELETE /v3/{teamSlug}/{projectId}/columns/{columnId} - Delete column
Rows
GET /v3/{teamSlug}/{projectId}/rows - List rows (paginated)GET /v3/{teamSlug}/{projectId}/rows/{rowId} - Get single rowPOST /v3/{teamSlug}/{projectId}/rows - Insert rowsPATCH /v3/{teamSlug}/{projectId}/rows/{rowId} - Update row cellsDELETE /v3/{teamSlug}/{projectId}/rows - Delete rows
Cells
PATCH /v3/{teamSlug}/{projectId}/cells - Batch update cells
Processing
POST /v3/{teamSlug}/{projectId}/trigger - Trigger row processingPOST /v3/{teamSlug}/{projectId}/stop - Stop processingGET /v3/{teamSlug}/{projectId}/status - Get processing status
Views
GET /v3/{teamSlug}/{projectId}/views - List viewsPOST /v3/{teamSlug}/{projectId}/views - Create viewPATCH /v3/{teamSlug}/{projectId}/views/{viewId} - Update viewDELETE /v3/{teamSlug}/{projectId}/views/{viewId} - Delete view
Quick Start
# List all projects
curl "https://fluar.com/api/v3/{teamSlug}/projects" \
-H "Authorization: Bearer fluar_sk_xxxxxxxxxxxxx"
# Insert a row
curl -X POST "https://fluar.com/api/v3/{teamSlug}/{projectId}/rows" \
-H "Authorization: Bearer fluar_sk_xxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]","company":"Acme"}'
# Trigger processing
curl -X POST "https://fluar.com/api/v3/{teamSlug}/{projectId}/trigger" \
-H "Authorization: Bearer fluar_sk_xxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{}'
Some read endpoints (rows, columns, project, status, views) may not require a Bearer token depending on project API settings. Write endpoints always require authentication.
Path Parameters
| Parameter | Description | Example |
|---|
teamSlug | Team slug from your Fluar URL | my-team |
projectId | Project UUID | 123e4567-e89b-12d3-a456-426614174000 |
columnId | Column ID | col_abc123def456 |
rowId | Row UUID | 550e8400-e29b-41d4-a716-446655440000 |
viewId | View UUID | 660f9500-f30c-52e5-b827-557766551111 |
{
"success": true,
"projects": [...]
}
{
"success": false,
"error": "Team not found"
}
Status Codes
| Status | Meaning |
|---|
| 200 | Success |
| 201 | Created |
| 400 | Invalid request |
| 401 | Missing API key |
| 403 | Invalid API key or API disabled |
| 404 | Resource not found |
| 429 | Rate limit exceeded |
| 500 | Server error |
OpenAPI Spec
The full OpenAPI 3.0.3 specification is available as JSON for AI agents and tooling:
https://fluar.com/openapi.json
curl https://fluar.com/openapi.json
More Details
