API · Beta

Tus tareas, listas y Gantts. Desde código.

Una API REST para conectar Floatask con n8n, Zapier, scripts o tus propios agentes de IA, y automatizar lo que hoy haces a mano.

Empezar en 2 minutos

Entra en Perfil → API keys y genera una clave. Se muestra una sola vez: guárdala.
Elige el alcance: lectura (solo consultar) o escritura (crear y modificar).
Envíala en la cabecera Authorization: Bearer ft_live_…

La API se activa por cuenta. Si no ves la sección de API keys en tu perfil, escríbenos a jmvaldes@icloud.com y te la habilitamos.

Ejemplos

Leer todo tu espacio

curl https://app.floatask.com/api/snapshot \
  -H "Authorization: Bearer ft_live_TU_CLAVE"

Crear un proyecto Gantt

curl -X POST https://app.floatask.com/api/plan/projects \
  -H "Authorization: Bearer ft_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"name":"Lanzamiento Q3","color":"slate"}'

Añadir una tarea con fecha concreta

curl -X POST https://app.floatask.com/api/tasks \
  -H "Authorization: Bearer ft_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"listId":123,"title":"Preparar la demo","dateType":"exact","date":"2026-08-01"}'

…o con una fecha flotante ("algún día de agosto")

curl -X POST https://app.floatask.com/api/tasks \
  -H "Authorization: Bearer ft_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"listId":123,"title":"Renovar el contrato","dateType":"month","monthNumber":8,"monthYear":2026}'

Endpoints principales

Recurso	Métodos	Ruta
Espacio completo	GET	`/api/snapshot`
Tareas	POST · PATCH · DELETE	`/api/tasks` · `/api/tasks/:id`
Listas	POST · PATCH · DELETE	`/api/lists` · `/api/lists/:id`
Comentarios	POST	`/api/tasks/:id/comments`
Proyectos Gantt	POST · PATCH · DELETE	`/api/plan/projects` · `/api/plan/projects/:id`
Grupos	POST · PATCH · DELETE	`/api/plan/groups` · `/api/plan/groups/:id`
Sesiones e hitos	POST · PATCH · DELETE	`/api/plan/items` · `/api/plan/items/:id`
Dependencias	POST · DELETE	`/api/plan/dependencies` · `/api/plan/dependencies/:id`
Personas y recursos	POST · PATCH · DELETE	`/api/plan/projects/:id/people` · `…/materials`

Valores de dateType: exact+date, week+weekNumber/weekYear, month+monthNumber/monthYear, year+year, o none.

Pensada para producción

Claves con alcance lectura/escritura y revocables al instante.
Límite de 120 peticiones/min por clave.
Heredan tus permisos y comparticiones; nunca tocan cuenta, facturación ni el asistente Floaty.

¿Construyes algo con la API? Cuéntanoslo — nos encanta ver qué integráis.

Generar mi clave