Semantics
Read-only. Returns task rows with id, title, status, priority, due_date, assignee. Filterable by `project_id` and/or `status_in`. The agent uses this to answer "what's open?" or to find a target task for `create_task` follow-ups.
Invariants
- Pure read. No state change.
- Tasks ordered by (due_date asc nulls last, then created_at asc).
When to use
When the user asks "what do I need to do on project X?" or to determine which work items still need attention.
Input schema
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"maximum": 200,
"minimum": 1
},
"status_in": {
"type": "array",
"items": {
"enum": [
"todo",
"doing",
"waiting",
"review",
"done"
],
"type": "string"
}
},
"project_id": {
"type": "string",
"description": "If omitted, returns tasks across all projects on the tenant."
},
"agent_vendor": {
"type": "string"
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"enum": [
"unknown_project",
"invalid_input"
],
"type": "string"
},
"tasks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"status": {
"type": "string"
},
"task_id": {
"type": "string"
},
"due_date": {
"type": "string",
"format": "date"
},
"priority": {
"type": "string"
},
"project_id": {
"type": "string"
},
"assignee_name": {
"type": "string"
}
}
}
}
}
}