{
"id": "community.gifthood.graph.getKnownFollowers",
"defs": {
"main": {
"type": "query",
"errors": [
{
"name": "AuthRequired",
"description": "The caller is not authenticated; known-follower lookup is viewer-relative and requires a session."
},
{
"name": "Unavailable",
"description": "A block exists in either direction between the viewer and the subject account; the known-follower list is not available."
}
],
"output": {
"schema": {
"type": "object",
"required": [
"count",
"followers"
],
"properties": {
"count": {
"type": "integer",
"description": "Total number of accounts the viewer follows who also follow the subject; may exceed the returned sample."
},
"followers": {
"type": "array",
"items": {
"ref": "community.gifthood.actor.defs#profileView",
"type": "ref"
},
"description": "A sample (≤ limit) of known followers, each a medium profileView."
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"required": [
"actor"
],
"properties": {
"actor": {
"type": "string",
"format": "did",
"description": "DID of the subject account."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of known followers to return in the sample."
}
}
},
"description": "Return the count and a sample of accounts the authenticated viewer follows who also follow the given subject. Viewer-relative: requires authentication (AuthRequired when logged out). A block in either direction between the viewer and the subject returns Unavailable. The count may exceed the returned sample (capped by limit)."
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1
}