ai

Parse natural language into a structured task (ALL PLANS - aiCore)

Extracts title, description, priority, dueDate, and assignee hints from free text.

post/ai/tasks/parse

Request

  • Base URL: https://api.onplana.com/api
  • URL: https://api.onplana.com/api/ai/tasks/parse
  • Auth: one of:
    • HTTP bearer
    • API key in header Authorization

Headers

X-Organization-Idstring required

UUID of the active organization. Sets org context for all scoped operations.

Request body

textstring required

Free-text task description, e.g. "Remind John to review the API design doc by Friday"

Response

Parsed task fields

idstring uuid required
titlestring required
status'TODO' | 'IN_PROGRESS' | 'REVIEW' | 'DONE' | 'BLOCKED' required
priority'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL' required
projectIdstring uuid required
assigneeIdstring uuid nullable
dueDatestring date-time nullable
estimatedHoursnumber nullable
progressinteger required
originalDurationMinutesinteger nullable

Planned duration in working minutes; a day is the project calendar hoursPerDay x 60 (default 480)

remainingDurationMinutesinteger nullable

Working minutes left; 0 when DONE

actualStartstring date nullable

Day work began (YYYY-MM-DD)

isManualboolean nullable

For a task with subtasks: true keeps its own dates, false takes its start and due dates from its subtasks, null follows the project's parentDatesFromSubtasks. Read only while the server switch parent_date_rollup_enabled is on.

datesFromSubtasksboolean

True when this task's start and due dates come from its subtasks right now (it has subtasks, is not a milestone or held by a live Planner sync, and its isManual or its project's default says so); a change to its dates, durations or constraint is then refused with PARENT_DATES_FROM_SUBTASKS. False whenever the server switch parent_date_rollup_enabled is off. On GET /tasks, /tasks/mine, /tasks/delegated-to-agents and /projects/{id}/tasks; the same flag the MCP task tools return.

optimisticDurationMinutesinteger nullable

Three-point estimate, best case, in working minutes. At most the task's duration (the remaining duration once started) when written; used by schedule risk runs. Null: the run's default range applies

pessimisticDurationMinutesinteger nullable

Three-point estimate, worst case, in working minutes. At least the task's duration (the remaining duration once started) when written

myRole'collaborator'

GET /tasks/mine only: present on a row the caller collaborates on but does not hold. Such a row also carries assignee; a row the caller holds carries neither.

Changes

No recorded changes to this operation across all 1 revision of this API.