Lexicon Garden

ink.branchline.getBuds

Hydrate full bud views for a set of AT-URIs. Buds are returned in the same order as the input URIs. Unknown URIs are silently omitted from the response.

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

Query

query · GET

Parameters

query string

uris

requiredarray

AT-URIs of buds to hydrate.

  • maxLength: 25
itemsstring · at-uri

Output

application/json

buds

requiredarray
itemsref
Reference

#authorView

object

Properties

did

requiredstring · did

displayName

string
  • maxLength: 640
  • maxGraphemes: 64

handle

requiredstring · handle

#budView

object

Properties

author

ref
Reference

bloomsAt

string · datetime

Timestamp when this bud finishes its growing window and blooms into the feed. Present on every bud; compare with the current time rather than relying on `growing` alone when a live countdown is needed.

children

array

AT-URIs of buds that extend this bud.

itemsstring · at-uri

cid

requiredstring · cid

createdAt

requiredstring · datetime

depth

requiredinteger

Depth of this bud in the story tree (0 = root).

  • minimum: 0

formatting

array
itemsref
Reference

growing

boolean

True when the bud has not yet reached its bloomsAt time and is still in the growing window.

intermediateCount

integer

Count of distinct contributor DIDs on the root-to-bud path, including the root author and this bud's author.

  • minimum: 0

locked

boolean

True when the bud's bloom time can no longer be extended.

pollenCount

requiredinteger

Lifetime number of pollen grains on this bud (raw count, not the ranking-weighted score).

  • minimum: 0

text

requiredstring

title

requiredstring

uri

requiredstring · at-uri

viewerBookmarked

boolean

True when the authenticated viewer has a bookmark whose subject is this bud. A bookmark earlier or later on the same lineage does not light this flag; only the exact subject does. Omitted when there is no viewer session.

viewerCanEdit

boolean

True when the authenticated viewer is permitted to edit this bud — they are the author, the bud has no children, and it is not locked. Omitted when there is no viewer session.

viewerPollinated

boolean

True when the authenticated viewer has already pollinated this bud. Omitted when there is no viewer session.

Similar lexicons

semantic match

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

  • ink.branchline.listAuthorBuds

    query

    List buds written by an author, surfacing only the terminal contributions per branch: a bud is included when the author has no descendant bud beneath it. Collapses back-and-forth exchanges so each chain the author participated in appears at most once, represented by their most recent bud in that chain.

  • ink.branchline.getSeeds

    query

    Hydrate seed views for a set of AT-URIs. Seeds are returned in the same order as the input URIs. Unknown URIs are silently omitted.

  • ink.branchline.getBranch

    query

    Get the full path of AT-URIs from root to bud in story order, oldest first.

  • ink.branchline.listBlooms

    query

    List active blooms: every bud past its 24h growing window. Blooms never age out of eligibility; the 'pollen' sort's time-decay weighting is what sinks stale entries. Supports 'recent' (newest createdAt first) and 'pollen' (decay-weighted pollen score across the bloom and its ancestors).

  • ink.branchline.listAuthorPlantings

    query

    List trees planted by an author. A planting is a root bud (depth 0) authored by `actor`; each entry reports the root AT-URI and the height of the tallest branch descended from it.