Skip to main content
Add a placement intention to the ledger. This writes a local intention. It does not check the source page or create a hosted monitor.

​
Example

Adds a local placement intention and prints its lk_ identifier. It does not check the page.

​
Options

  • --source URL and --target URL required
  • --intent wanted|expected|retired defaults to wanted
  • --scope exact|domain|subdomain|path defaults to exact
  • --anchor TEXT
  • --rel comma,separated
  • --cadence daily|weekly|monthly or 3600..2592000 seconds
  • --ref TEXT
  • repeat --tag TEXT
  • --note TEXT.

​
Exit status

0 on success; 2 on usage, configuration, input or request failure.

​
What happens

Prints the new lk_ identifier. Duplicate source, target and scope combinations fail. This command records intent without checking the page. Wanted defaults to weekly cadence, expected to daily, and retired has no default cadence.
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.