dev.cocore.account.listIncomingFriends Documentation (EN)

main query

Every `dev.cocore.account.friend` record whose subject equals the queried DID — "who has trusted me with work?". Newest first; frienders are hydrated to a handle via the public Bluesky AppView when no local profile exists.

Parameters

did string did Required

A decentralized identifier (DID).

limit integer Optional

No description available.

Output

Encodingapplication/json

friends array Required

No description available.

total integer Required

No description available.

Errors

InvalidRequest The `did` parameter is missing or not a DID.

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

did * A decentralized identifier (DID).

limit

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "InvalidRequest",
      "description": "The `did` parameter is missing or not a DID."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "friends",
        "total"
      ],
      "properties": {
        "total": {
          "type": "integer"
        },
        "friends": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "friender",
              "subject"
            ],
            "properties": {
              "uri": {
                "type": "string",
                "format": "at-uri"
              },
              "subject": {
                "type": "string",
                "format": "did"
              },
              "friender": {
                "type": "string",
                "format": "did"
              },
              "createdAt": {
                "type": "string",
                "format": "datetime"
              },
              "frienderHandle": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "did"
    ],
    "properties": {
      "did": {
        "type": "string",
        "format": "did"
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 200,
        "minimum": 1
      }
    }
  },
  "description": "Every `dev.cocore.account.friend` record whose subject equals the queried DID — \"who has trusted me with work?\". Newest first; frienders are hydrated to a handle via the public Bluesky AppView when no local profile exists."
}