lb_update_para_item
Mutates editable fields on a PARA item. At least one of label, description, or deadline must be provided.
Parameters
Section titled “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
Section titled “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
Section titled “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
Section titled “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). deadlineaccepts calendar-date format only (YYYY-MM-DD). Strings like"next Friday"or"12/31/2026"are rejected by the schema.