lb_update_para_item

Mutates editable fields on a PARA item. At least one of label, description, or deadline must be provided.

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | id | string | Yes | The ID of the PARA item to update | | label | string | No | New label. Must be non-empty | | description | string | No | New description. Pass "" to clear | | deadline | string (ISO-8601 date) | No | New deadline as YYYY-MM-DD. Schema-validated |

Response

Returns the full updated PARA item:

{
  "id": "...",
  "category": "projects",
  "slug": "my-project",
  "label": "Renamed Project",
  "description": "New description",
  "deadline": "2026-12-31",
  "status": "active",
  "created_at": "..."
}

Errors

| Code | When | |------|------| | INVALID_INPUT | No update fields were provided, or deadline is not a valid ISO-8601 date | | NOT_FOUND | The PARA item does not exist in the current tenant |

Usage notes

• To change category, slug, or status, use the purpose-built tools: create a new item (lb_create_para_item), archive (lb_archive_para_item), or unarchive (lb_unarchive_para_item).
• deadline accepts calendar-date format only (YYYY-MM-DD). Strings like "next Friday" or "12/31/2026" are rejected by the schema.