Skip to main content

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

https://fluar.com/api

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

ParameterDescriptionExample
projectIdProject UUID123e4567-e89b-12d3-a456-426614174000
columnIdColumn IDcol_abc123def456
rowIdRow UUID550e8400-e29b-41d4-a716-446655440000
viewIdView UUID660f9500-f30c-52e5-b827-557766551111

Response Format

{
  "success": true,
  "projects": [...]
}
{
  "success": false,
  "error": "Bearer token is required"
}

Status Codes

StatusMeaning
200Success
201Created
400Invalid request
401Missing API key
403Invalid API key or API disabled
404Resource not found
429Rate limit exceeded
500Server 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