API · Beta
Your tasks, lists and Gantts. From code.
A REST API to connect Floatask with n8n, Zapier, scripts or your own AI agents, and automate what you do by hand today.
Get started in 2 minutes
- Go to Profile → API keys and generate a key. It's shown only once: save it.
- Pick the scope: read (query only) or write (create and modify).
- Send it in the
Authorization: Bearer ft_live_…header.
The API is enabled per account. If you don't see the API keys section in your profile, email us at jmvaldes@icloud.com and we'll turn it on.
Examples
Read your whole workspace
curl https://app.floatask.com/api/snapshot \
-H "Authorization: Bearer ft_live_YOUR_KEY"Create a Gantt project
curl -X POST https://app.floatask.com/api/plan/projects \
-H "Authorization: Bearer ft_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Q3 Launch","color":"slate"}'Add a task with an exact date
curl -X POST https://app.floatask.com/api/tasks \
-H "Authorization: Bearer ft_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"listId":123,"title":"Prep the demo","dateType":"exact","date":"2026-08-01"}'…or with a floating date ("sometime in August")
curl -X POST https://app.floatask.com/api/tasks \
-H "Authorization: Bearer ft_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"listId":123,"title":"Renew the contract","dateType":"month","monthNumber":8,"monthYear":2026}'Main endpoints
| Resource | Methods | Path |
|---|---|---|
| Full workspace | GET | /api/snapshot |
| Tasks | POST · PATCH · DELETE | /api/tasks · /api/tasks/:id |
| Lists | POST · PATCH · DELETE | /api/lists · /api/lists/:id |
| Comments | POST | /api/tasks/:id/comments |
| Gantt projects | POST · PATCH · DELETE | /api/plan/projects · /api/plan/projects/:id |
| Groups | POST · PATCH · DELETE | /api/plan/groups · /api/plan/groups/:id |
| Sessions & milestones | POST · PATCH · DELETE | /api/plan/items · /api/plan/items/:id |
| Dependencies | POST · DELETE | /api/plan/dependencies · /api/plan/dependencies/:id |
| People & resources | POST · PATCH · DELETE | /api/plan/projects/:id/people · …/materials |
dateType values: exact+date,
week+weekNumber/weekYear,
month+monthNumber/monthYear,
year+year, or none.
Built for production
- Keys with read/write scope, revocable instantly.
- 120 requests/min per key.
- They inherit your permissions and shares; they never touch account, billing or the Floaty assistant.
Building something with the API? Tell us — we love seeing what you integrate.
Generate my key