Writes

Create Or Update One Bookmark At A Time

CLI writes are intentionally narrow. Use them when you want to create or update a specific bookmark or folder. Bulk changes, recursive changes, and automatic organization are not part of these commands.

Create A Bookmark Or Folder

webcull bookmarks create --account <account-hash> --url https://acme.example/pricing --title "Acme pricing" --parent-id 2301 --dry-run

{
  "success": "true",
  "dry_run": "true",
  "action": "create",
  "id": 2302,
  "type": "bookmark",
  "parent_id": 2301,
  "would_update": ["url", "title", "parent_id"]
}

Use --dry-run before saving when you want to confirm the destination, account access, or encrypted-account behavior first.

Patch Only The Fields That Should Change

webcull bookmarks update 2302 --account <account-hash> --notes "Review before Q3 campaign planning."

{
  "success": "true",
  "action": "update",
  "id": 2302,
  "type": "bookmark",
  "parent_id": 2301
}

Update commands preserve fields not included in the command. Send the narrowest patch that completes the requested change.

Refresh One Bookmark From Its Saved Page

webcull bookmarks proxy 2302 --account <account-hash> --fields title,icon,description
webcull bookmarks proxy 2302 --account <account-hash> --exclude description

The proxy command refreshes the selected title, icon, and description for one bookmark. With no field options, it refreshes all three. Use --fields to include specific fields or --exclude to leave fields unchanged.

webcull bookmarks create --account <account-hash> --url https://acme.example/pricing --parent-id 2301 --proxy --proxy-fields title,icon

Add --proxy, --proxy-fields, or --proxy-exclude when creating a bookmark to refresh page metadata immediately after it is saved. Metadata refresh is unavailable for E2EE accounts.