list_plans
List plans visible to the authenticated user with filters and pagination.
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Page number (default 1)."
},
"sort": {
"type": "string",
"description": "Sort order: \"due_asc_nulls_last\" (default — best for action planning) | \"created_desc\" (newest first)."
},
"stage": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of stage enum values. Use UNDERSCORE form In_Process. Allowed: Suggested, Accepted, In_Process, Complete, Dismissed. Omit for all stages. Note: only the first array element is honored currently — pass single-value arrays to be safe."
},
"source": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of source enum values: user_added, cora_proactive, cora_requested, workflow, playbook. Note: only the first array element is honored currently — pass single-value arrays to be safe."
},
"per_page": {
"type": "integer",
"description": "Items per page (default 20, max 100)."
},
"due_after": {
"type": "string",
"description": "ISO date YYYY-MM-DD. Returns plans with due_date >= due_after. Note: does not apply yet."
},
"due_before": {
"type": "string",
"description": "ISO date YYYY-MM-DD. Returns plans with due_date <= due_before. Note: does not apply yet."
},
"project_id": {
"type": "string",
"description": "Filter to plans associated with this project (project UUID string)."
},
"category_id": {
"type": "integer",
"description": "Filter to plans in this content category (integer ID). Omit (or pass 0/null) for NO category filter — all plans return, including uncategorized ones."
},
"search_text": {
"type": "string",
"description": "Substring match on plan title (case-insensitive). Note: does not apply yet."
},
"assignee_scope": {
"type": "string",
"description": "Whose plans to return. \"me\" (default — plans assigned to you) | \"created_by_me\" (plans you created) | \"all_visible\" (all plans visible to your team)."
}
}
}Output Schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"stage": {
"type": "string"
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"due_date": {
"type": "string"
},
"plan_uuid": {
"type": "string"
},
"created_at": {
"type": "string"
},
"created_by": {
"type": "integer"
},
"updated_at": {
"type": "string"
},
"assigned_to": {
"type": "integer"
},
"produced_content_id": {
"type": "string"
}
}
}
},
"curPage": {
"type": "integer"
},
"nextPage": {
"type": "integer"
},
"prevPage": {
"type": "integer"
},
"itemsTotal": {
"type": "integer"
}
}
}Instructions
Returns a paginated list of plans visible to the authenticated user. Use filters to narrow results by stage, source, project, or category.
Stage filter values: Use UNDERSCORE form — In_Process (not In Process). Allowed: Suggested, Accepted, In_Process, Complete, Dismissed. Note: only the first array element is honored currently.
Source filter values: user_added, cora_proactive, cora_requested, workflow, playbook. Note: only the first array element is honored currently.
Assignee scope: me (default — plans assigned to you), created_by_me (plans you created), all_visible (all plans visible to you).
Sorting: due_asc_nulls_last (default — soonest due date first, nulls last) or created_desc (newest first).
Pagination: Use page and per_page (max 100). The response includes nextPage and prevPage for traversal.
Note: due_before, due_after, and search_text filters are accepted but do not apply yet.
