Skip to main content

com.atproto.label.queryLabels

GET 
/xrpc/com.atproto.label.queryLabels

To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.

Find labels relevant to the provided AT-URI patterns. Public endpoint for moderation services, though may return different or additional results with auth.

Request​

Query Parameters

    uriPatterns string[]required

    List of AT URI patterns to match (boolean 'OR'). Each may be a prefix (ending with ''; will match inclusive of the string leading to ''), or a full URI.

    sources did[]

    Optional list of label sources (DIDs) to filter on.

    limit integer

    Possible values: >= 1 and <= 250

    Default value: 50

    cursor string

Responses​

OK

Schema

    cursor string

    labels

    object[]

    required

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

Loading...