ink.branchline.publishSeed

Gift a seed. The caller must be signed in and must be the grantee of `grantor`; publishing passes that seed's planting right on to `grantee` as a new child seed. The AppView writes an ink.branchline.seed record to the caller's PDS and mirrors it into the local read cache. Root (grantor-less) seeds are not created through this endpoint — they are authored only by the branchline.ink repo.

Repository @branchline.ink did:plc:brvu7akhdvsqcomb67pafw25 namespace authority
Details · procedure
Kindprocedure
Authoritybranchline.ink
Indexed

Procedure

procedure · POST

Input

application/json

expiresAt

string · datetime

Optional expiry for the new grant. Must not extend past the grantor chain's earliest expiry.

grantee

requiredstring · did

DID of the new grantee receiving the gift.

grantor

requiredstring · at-uri

AT-URI of the seed the caller currently holds as grantee.

Output

application/json

cid

requiredstring · cid

uri

requiredstring · at-uri

Errors

Unauthorized

The caller is not signed in.

GrantorNotFound

The grantor seed does not exist in the AppView.

NotGrantee

The caller is not the grantee of the grantor seed.

GrantorExpired

The grantor seed's expiry has passed.

GrantorAlreadyGranted

The grantor seed has already been granted to another recipient.

Similar lexicons

semantic match

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

  • 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.

  • 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.