Tasks
List Tasks
List the AI-generated optimization tasks for a project — concrete, prioritized to-dos derived from your visibility data, sorted by priority score.
GET
Optimization tasks are generated automatically from your project’s AI visibility data — for example fixing crawl errors AI bots hit, answering high-potential community threads, closing competitor gaps, or reworking weak content. This endpoint returns the same tasks as the Tasks page in the Finseo dashboard.
Rows are compact and sorted by
priorityScore (impact weighted against effort — higher means do it first). Use Get Task with a task id for the full description, step-by-step plan and evidence.
The Tasks module is currently in beta. Tasks are read-only via the API — status changes happen in the dashboard.
string
required
The project ID
string
default:"open"
Comma-separated statuses to include —
open, in_progress, done, dismissed, or allstring
Filter by category —
technical, visibility, content, offsite, reputation, competitor, or setupinteger
Only return tasks with at least this impact score (1–10)
integer
default:"1"
Page number
integer
default:"50"
Results per page (max 200)