community.gifthood.feed.getActivity Documentation (EN)

main query

The signed-in viewer's two-directional gifting activity — outgoing interests + incoming raised hands on their listings, merged newest-first by createdAt. Viewer-private: resolved from the session (no actor param); an unauthenticated caller gets an AuthRequired error.

Parameters

cursor string Optional

Reserved for future pagination; ignored in this version.

limit integer Optional

Maximum rows fetched per direction (interests, hands); the merged feed can return up to twice this. A safety cap, not a pagination control — pagination is reserved (see cursor).

Output

Encodingapplication/json

activity array Required

The merged activity rows, newest-first by createdAt.

cursor string Optional

Reserved; not emitted in this version.

Errors

AuthRequired No authenticated viewer. This feed is inherently viewer-private and is never served unauthenticated — the caller (the page) owns any login redirect.

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://api.bsky.social)

Parameters

cursor Reserved for future pagination; ignored in this version.

limit Maximum rows fetched per direction (interests, hands); the merged feed can return up to twice this. A safety cap, not a pagination control — pagination is reserved (see cursor).

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "AuthRequired",
      "description": "No authenticated viewer. This feed is inherently viewer-private and is never served unauthenticated — the caller (the page) owns any login redirect."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "activity"
      ],
      "properties": {
        "cursor": {
          "type": "string",
          "description": "Reserved; not emitted in this version."
        },
        "activity": {
          "type": "array",
          "items": {
            "ref": "community.gifthood.feed.defs#activityView",
            "type": "ref"
          },
          "description": "The merged activity rows, newest-first by createdAt."
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 100,
        "maximum": 100,
        "minimum": 1,
        "description": "Maximum rows fetched per direction (interests, hands); the merged feed can return up to twice this. A safety cap, not a pagination control — pagination is reserved (see cursor)."
      },
      "cursor": {
        "type": "string",
        "description": "Reserved for future pagination; ignored in this version."
      }
    }
  },
  "description": "The signed-in viewer's two-directional gifting activity — outgoing interests + incoming raised hands on their listings, merged newest-first by createdAt. Viewer-private: resolved from the session (no actor param); an unauthenticated caller gets an AuthRequired error."
}