ink.branchline.createPollen Documentation (EN)

main procedure

Pollinate a bud — a lightweight mark of appreciation. The caller must be signed in. The AppView writes an ink.branchline.pollen record to the caller's PDS and mirrors it into the local read cache. At most one pollen grain per (author, subject) is honored; retrying a call for the same subject is rejected with DuplicatePollen.

Input

Encodingapplication/json

subjectUri stringat-uri Required

AT-URI of the ink.branchline.bud record to pollinate.

Output

Encodingapplication/json

cid stringcid Required

A content identifier (CID) referencing immutable data.

uri stringat-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

Errors

Unauthorized The caller is not signed in.

SubjectNotFound The subject bud does not exist in the AppView.

SelfPollinate The caller is the subject bud's author. Authors cannot pollinate their own buds.

DuplicatePollen The caller has already pollinated this subject.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "subjectUri"
      ],
      "properties": {
        "subjectUri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI of the ink.branchline.bud record to pollinate."
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "Unauthorized",
      "description": "The caller is not signed in."
    },
    {
      "name": "SubjectNotFound",
      "description": "The subject bud does not exist in the AppView."
    },
    {
      "name": "SelfPollinate",
      "description": "The caller is the subject bud's author. Authors cannot pollinate their own buds."
    },
    {
      "name": "DuplicatePollen",
      "description": "The caller has already pollinated this subject."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "uri",
        "cid"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "format": "cid"
        },
        "uri": {
          "type": "string",
          "format": "at-uri"
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Pollinate a bud — a lightweight mark of appreciation. The caller must be signed in. The AppView writes an ink.branchline.pollen record to the caller's PDS and mirrors it into the local read cache. At most one pollen grain per (author, subject) is honored; retrying a call for the same subject is rejected with DuplicatePollen."
}