blue.microcosm.links.getManyToMany

microcosm.blue

Documentation

Get records that link out to both a primary and secondary subject

main query

Get records that link out to both a primary and secondary subject

Parameters

limit integer Optional

number of results to return

linkDid array of string Optional

filter linking records from specific users

otherSubject array of string Optional

filter secondary links to specific subjects

pathToOther string Required

path to the secondary link in the many-to-many record (e.g., 'otherThing.uri')

source string Required

collection and path specification for the primary link (e.g., 'app.bsky.feed.like:subject.uri')

subject string uri Required

the primary target being linked to (at-uri, did, or uri)

Output

Encodingapplication/json
cursor string Optional

No description available.

items array Required

No description available.

Try It

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

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
number of results to return
filter linking records from specific users
filter secondary links to specific subjects
path to the secondary link in the many-to-many record (e.g., 'otherThing.uri')
collection and path specification for the primary link (e.g., 'app.bsky.feed.like:subject.uri')
the primary target being linked to (at-uri, did, or uri)
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "items"
      ],
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "ref": "#item",
            "type": "ref"
          }
        },
        "cursor": {
          "type": "string"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "subject",
      "source",
      "pathToOther"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "default": 16,
        "maximum": 100,
        "minimum": 1,
        "description": "number of results to return"
      },
      "source": {
        "type": "string",
        "description": "collection and path specification for the primary link (e.g., 'app.bsky.feed.like:subject.uri')"
      },
      "linkDid": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "did"
        },
        "description": "filter linking records from specific users"
      },
      "subject": {
        "type": "string",
        "format": "uri",
        "description": "the primary target being linked to (at-uri, did, or uri)"
      },
      "pathToOther": {
        "type": "string",
        "description": "path to the secondary link in the many-to-many record (e.g., 'otherThing.uri')"
      },
      "otherSubject": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "filter secondary links to specific subjects"
      }
    }
  },
  "description": "Get records that link out to both a primary and secondary subject"
}
item object

No description available.

Properties

linkRecord ref #linkRecord Required

reference to the link record itself

otherSubject string Required

the secondary subject from the link record

View raw schema 
{
  "type": "object",
  "required": [
    "linkRecord",
    "otherSubject"
  ],
  "properties": {
    "linkRecord": {
      "ref": "#linkRecord",
      "type": "ref",
      "description": "reference to the link record itself"
    },
    "otherSubject": {
      "type": "string",
      "description": "the secondary subject from the link record"
    }
  }
}
linkRecord object

A record identifier consisting of a DID, collection, and record key

Properties

collection string nsid Required

the collection of the linking record

did string did Required

the DID of the linking record's repository

rkey string record-key Required

A valid record key for AT Protocol repositories.

View raw schema 
{
  "type": "object",
  "required": [
    "did",
    "collection",
    "rkey"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "the DID of the linking record's repository"
    },
    "rkey": {
      "type": "string",
      "format": "record-key"
    },
    "collection": {
      "type": "string",
      "format": "nsid",
      "description": "the collection of the linking record"
    }
  },
  "description": "A record identifier consisting of a DID, collection, and record key"
}

Lexicon Garden

@