Overview
The Fluar API lets you fully manage projects, columns, rows, cells, and processing from external applications and AI agents. The v4 API is the latest version with simplified authentication — your Bearer token identifies your team automatically.
Base URL
v4 Endpoints
Projects
GET /v4/projects - List all projects
POST /v4/projects - Create a project
GET /v4/projects/{projectId} - Get project with columns
PATCH /v4/projects/{projectId} - Update project settings
Columns
GET /v4/projects/{projectId}/columns - List columns (full config)
GET /v4/projects/{projectId}/columns/templates - List available column templates
POST /v4/projects/{projectId}/columns - Create column from template
PATCH /v4/projects/{projectId}/columns/{columnId} - Update column (with autofix)
DELETE /v4/projects/{projectId}/columns/{columnId} - Delete column
Rows
GET /v4/projects/{projectId}/rows - List rows (paginated)
GET /v4/projects/{projectId}/rows/{rowId} - Get single row
POST /v4/projects/{projectId}/rows - Insert rows
PATCH /v4/projects/{projectId}/rows/{rowId} - Update row cells
DELETE /v4/projects/{projectId}/rows - Delete rows
Cells
PATCH /v4/projects/{projectId}/cells - Batch update cells
Processing
POST /v4/projects/{projectId}/trigger - Trigger row processing
POST /v4/projects/{projectId}/stop - Stop processing
GET /v4/projects/{projectId}/status - Get processing status
Views
GET /v4/projects/{projectId}/views - List views
POST /v4/projects/{projectId}/views - Create view
PATCH /v4/projects/{projectId}/views/{viewId} - Update view
DELETE /v4/projects/{projectId}/views/{viewId} - Delete view
Quick Start
# List all projects
curl "https://fluar.com/api/v4/projects" \
-H "Authorization: Bearer fluar_sk_xxxxxxxxxxxxx"
# Insert a row
curl -X POST "https://fluar.com/api/v4/projects/{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/v4/projects/{projectId}/trigger" \
-H "Authorization: Bearer fluar_sk_xxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{}'
All v4 endpoints require a Bearer token. Your API key identifies your team — no team slug needed in the URL.
Path Parameters
| Parameter | Description | Example |
|---|
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": "Bearer token is required"
}
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
More Details