# project_update_save

Post a Project Update

## Beschreibung

Posts a status update on a project (Linear's `save_status_update`).
Optional `health` records the project's health: pass one of
`on_track | at_risk | off_track`, or omit for no health change.

## 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 |  |
| `project_id` | string | Ja | Project prefix ID (proj_…) or slug. |
| `body` | string | Ja | Update body (plain text or Markdown). |
| `health` | string / null | Nein | on_track, at_risk, or off_track. Optional. |

## Eingabeschema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "account_id": {
      "type": "string"
    },
    "project_id": {
      "type": "string",
      "description": "Project prefix ID (proj_…) or slug."
    },
    "body": {
      "type": "string",
      "description": "Update body (plain text or Markdown)."
    },
    "health": {
      "type": [
        "string",
        "null"
      ],
      "description": "on_track, at_risk, or off_track. Optional."
    }
  },
  "required": [
    "account_id",
    "project_id",
    "body"
  ],
  "type": "object"
}
```

## Ausgabeschema

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