pub.chive.tag.listForEprint

lexicons.governance.chive.pub

Documentation

List tags for a specific eprint with TaxoFolk suggestions

main query

List tags for a specific eprint with TaxoFolk suggestions

Parameters

eprintUri string at-uri Required

AT-URI of the eprint to list tags for

Output

Encodingapplication/json
suggestions array Optional

TaxoFolk suggestions based on existing tags

tags array Required

Tags applied to the eprint

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
AT-URI of the eprint to list tags for
View raw schema 
{
  "description": "List tags for a specific eprint with TaxoFolk suggestions",
  "errors": [],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "suggestions": {
          "description": "TaxoFolk suggestions based on existing tags",
          "items": {
            "ref": "#tagSuggestion",
            "type": "ref"
          },
          "type": "array"
        },
        "tags": {
          "description": "Tags applied to the eprint",
          "items": {
            "ref": "#userTag",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "tags"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "eprintUri": {
        "description": "AT-URI of the eprint to list tags for",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "eprintUri"
    ],
    "type": "params"
  },
  "type": "query"
}
authorRef object

Reference to an author

Properties

avatar string uri Optional

Avatar URL

did string did Required

Author DID

displayName string Optional

Display name

handle string Optional

Author handle

View raw schema 
{
  "description": "Reference to an author",
  "properties": {
    "avatar": {
      "description": "Avatar URL",
      "format": "uri",
      "type": "string"
    },
    "did": {
      "description": "Author DID",
      "format": "did",
      "type": "string"
    },
    "displayName": {
      "description": "Display name",
      "type": "string"
    },
    "handle": {
      "description": "Author handle",
      "type": "string"
    }
  },
  "required": [
    "did"
  ],
  "type": "object"
}
tagSuggestion object

A tag suggestion from the TaxoFolk system

Properties

confidence integer Required

Suggestion confidence (0-100, scaled from 0-1)

minimum: 0maximum: 100
displayForm string Required

Suggested display form

matchedTerm string Optional

Term that triggered this suggestion

normalizedForm string Required

Normalized form of the suggestion

source string Required

Source of the suggestion

Known values: cooccurrence, authority, facet
View raw schema 
{
  "description": "A tag suggestion from the TaxoFolk system",
  "properties": {
    "confidence": {
      "description": "Suggestion confidence (0-100, scaled from 0-1)",
      "maximum": 100,
      "minimum": 0,
      "type": "integer"
    },
    "displayForm": {
      "description": "Suggested display form",
      "type": "string"
    },
    "matchedTerm": {
      "description": "Term that triggered this suggestion",
      "type": "string"
    },
    "normalizedForm": {
      "description": "Normalized form of the suggestion",
      "type": "string"
    },
    "source": {
      "description": "Source of the suggestion",
      "knownValues": [
        "cooccurrence",
        "authority",
        "facet"
      ],
      "type": "string"
    }
  },
  "required": [
    "displayForm",
    "normalizedForm",
    "confidence",
    "source"
  ],
  "type": "object"
}
userTag object

A user-applied tag on an eprint

Properties

cid string Required

Content identifier

createdAt string datetime Required

Creation timestamp

displayForm string Required

Original display form of the tag

eprintUri string at-uri Required

Tagged eprint AT-URI

normalizedForm string Required

Normalized form (lowercase, hyphenated)

uri string at-uri Required

Tag AT-URI

View raw schema 
{
  "description": "A user-applied tag on an eprint",
  "properties": {
    "author": {
      "description": "Tag creator",
      "ref": "#authorRef",
      "type": "ref"
    },
    "cid": {
      "description": "Content identifier",
      "type": "string"
    },
    "createdAt": {
      "description": "Creation timestamp",
      "format": "datetime",
      "type": "string"
    },
    "displayForm": {
      "description": "Original display form of the tag",
      "type": "string"
    },
    "eprintUri": {
      "description": "Tagged eprint AT-URI",
      "format": "at-uri",
      "type": "string"
    },
    "normalizedForm": {
      "description": "Normalized form (lowercase, hyphenated)",
      "type": "string"
    },
    "uri": {
      "description": "Tag AT-URI",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "cid",
    "eprintUri",
    "author",
    "displayForm",
    "normalizedForm",
    "createdAt"
  ],
  "type": "object"
}

Lexicon Garden

@