ink.branchline.publishBud

{
  "id": "ink.branchline.publishBud",
  "defs": {
    "main": {
      "type": "procedure",
      "input": {
        "schema": {
          "type": "object",
          "required": [
            "parentUri",
            "title",
            "text"
          ],
          "properties": {
            "text": {
              "type": "string",
              "maxLength": 20000
            },
            "title": {
              "type": "string",
              "maxLength": 1200,
              "maxGraphemes": 120
            },
            "parentUri": {
              "type": "string",
              "format": "at-uri",
              "description": "AT-URI of the parent — either an ink.branchline.bud (continuation) or an ink.branchline.seed (root bud being planted)."
            },
            "formatting": {
              "type": "array",
              "items": {
                "ref": "ink.branchline.bud#formatSpan",
                "type": "ref"
              },
              "description": "Byte-offset inline formatting spans over `text`."
            }
          }
        },
        "encoding": "application/json"
      },
      "errors": [
        {
          "name": "Unauthorized",
          "description": "The caller is not signed in."
        },
        {
          "name": "ParentNotFound",
          "description": "The parent (bud or seed) does not exist in the AppView."
        },
        {
          "name": "ParentCidMismatch",
          "description": "The resolved parent's CID does not match the value on the record."
        },
        {
          "name": "SelfReply",
          "description": "The caller is the parent bud's author. Buds cannot continue themselves."
        },
        {
          "name": "ParentGrowing",
          "description": "The parent bud is still inside its 24h growing window."
        },
        {
          "name": "WordLimitExceeded",
          "description": "The bud text exceeds the 500-word ceiling."
        },
        {
          "name": "InvalidFormatting",
          "description": "A formatting span is malformed — offsets out of bounds, start >= end, or an unknown span type."
        },
        {
          "name": "NotSeedGrantee",
          "description": "The caller is not the grantee of the seed they are trying to plant."
        },
        {
          "name": "SeedExpired",
          "description": "The seed's expiry has passed."
        },
        {
          "name": "SeedChainBroken",
          "description": "The seed's ancestor chain is missing, expired, or broken by a grantor/grantee mismatch."
        },
        {
          "name": "SeedAlreadyPlanted",
          "description": "Another bud has already been planted from this seed."
        }
      ],
      "output": {
        "schema": {
          "type": "object",
          "required": [
            "uri",
            "cid"
          ],
          "properties": {
            "cid": {
              "type": "string",
              "format": "cid"
            },
            "uri": {
              "type": "string",
              "format": "at-uri"
            }
          }
        },
        "encoding": "application/json"
      },
      "description": "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."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}