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.