# project_list

List Projects

## Beschreibung

Lists projects the caller can read in the account. Each row
includes the project's `proj_…` prefix ID — pass it back to
`project_get`, `task_save({project_id: …})`, etc. Filter by
`workspace_id`, status (`backlog | planned | in_progress | paused |
completed | cancelled`), `priority` (`urgent | high | medium |
low | no_priority`), and `archived` (defaults to false).
Sorted by name. `progress_ratio` is computed live from
`completed_tasks / total_tasks`.

## Zugriff

Zugriffsprofil: `gated`. Module: `projects_tasks`.
Die Freigabe im Profil ersetzt keine Account-, Workspace- oder Rollenberechtigung.

## Parameter

| Name | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `account_id` | string | Ja | Account prefix ID. |
| `workspace_id` | string | Nein | Workspace prefix ID or key (e.g. ENG). |
| `status` | string | Nein | Project status enum key. |
| `priority` | string | Nein | Priority enum key. |
| `archived` | boolean | Nein | Include archived projects (default false). |
| `query` | string | Nein | Substring match on name or summary. |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Account prefix ID."
    },
    "workspace_id": {
      "type": "string",
      "description": "Workspace prefix ID or key (e.g. ENG)."
    },
    "status": {
      "type": "string",
      "description": "Project status enum key."
    },
    "priority": {
      "type": "string",
      "description": "Priority enum key."
    },
    "archived": {
      "type": "boolean",
      "description": "Include archived projects (default false)."
    },
    "query": {
      "type": "string",
      "description": "Substring match on name or summary."
    }
  },
  "required": [
    "account_id"
  ],
  "type": "object"
}
```

## Ausgabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ]
      }
    }
  },
  "required": [
    "projects"
  ],
  "type": "object"
}
```