Lexicon Garden

ink.branchline.editBud

Edit the title, text, and/or inline formatting of an existing bud. The caller must be signed in and must be the bud's author. The bud must have no children and must not be locked — edits to a bud with descendants would reshape text that later writers have already continued from, and locked buds are frozen by an admin. The AppView overwrites the ink.branchline.bud record in the caller's PDS via putRecord and mirrors the new row into the local read cache. `createdAt` and `bloomsAt` are preserved; the PDS assigns a new CID.

Repository @branchline.ink did:plc:brvu7akhdvsqcomb67pafw25 namespace authority
Details · procedure
Kindprocedure
Authoritybranchline.ink
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

formatting

array

Byte-offset inline formatting spans over `text`. Replaces any prior spans on the bud.

itemsref
Reference

text

requiredstring
  • maxLength: 20000

title

requiredstring
  • maxLength: 1200
  • maxGraphemes: 120

uri

requiredstring · at-uri

AT-URI of the bud to edit.

Output

application/json

cid

requiredstring · cid

The new CID assigned by the PDS after the record is overwritten.

uri

requiredstring · at-uri

Errors

Unauthorized

The caller is not signed in.

BudNotFound

No bud exists at the given URI in the AppView.

NotOwner

The caller is not the bud's author.

BudHasChildren

The bud has one or more continuations and can no longer be edited.

BudLocked

The bud has been locked by an admin and can no longer be edited.

WordLimitExceeded

The edited bud text exceeds the 500-word ceiling.

InvalidFormatting

A formatting span is malformed — offsets out of bounds, start >= end, or an unknown span type.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • ink.branchline.publishBud

    procedure

    Publish a new bud. The parent may be another bud (continuation) or a seed (planting a root bud). The caller must be signed in. The AppView writes an ink.branchline.bud record to the caller's PDS and mirrors it into the local read cache so the new bud is immediately navigable. Rejection reasons mirror ink.branchline.bud create validation — 500-word limit on `text`, 24h parent growing window, self-reply, seed chain/expiry/grantee checks, etc.

  • app.bivri.feed.updateComment

    procedure

    Edit the text of a comment the authenticated member owns. The artwork and reply parent remain unchanged.

  • ink.branchline.bud

    record

    A bud: one contribution to a story tree. Freshly written buds grow for 24h (not yet followable); after that they open as 'blooms' that other writers can extend; past 48h without children they lock into 'branches'. These lifecycle stages are views of the same record, not different record types. The AppView enforces a 500-word ceiling on `text` (counted via Unicode word segmentation); writes that exceed it are rejected as WordLimitExceeded.