{
"id": "pub.chive.tag.listForEprint",
"defs": {
"main": {
"type": "query",
"errors": [],
"output": {
"schema": {
"type": "object",
"required": [
"tags"
],
"properties": {
"tags": {
"type": "array",
"items": {
"ref": "#userTag",
"type": "ref"
},
"description": "Tags applied to the eprint"
},
"suggestions": {
"type": "array",
"items": {
"ref": "#tagSuggestion",
"type": "ref"
},
"description": "TaxoFolk suggestions based on existing tags"
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"required": [
"eprintUri"
],
"properties": {
"eprintUri": {
"type": "string",
"format": "at-uri",
"description": "AT-URI of the eprint to list tags for"
}
}
},
"description": "List tags for a specific eprint with TaxoFolk suggestions"
},
"userTag": {
"type": "object",
"required": [
"uri",
"cid",
"eprintUri",
"author",
"displayForm",
"normalizedForm",
"createdAt"
],
"properties": {
"cid": {
"type": "string",
"description": "Content identifier"
},
"uri": {
"type": "string",
"format": "at-uri",
"description": "Tag AT-URI"
},
"author": {
"ref": "#authorRef",
"type": "ref",
"description": "Tag creator"
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "Creation timestamp"
},
"eprintUri": {
"type": "string",
"format": "at-uri",
"description": "Tagged eprint AT-URI"
},
"displayForm": {
"type": "string",
"description": "Original display form of the tag"
},
"normalizedForm": {
"type": "string",
"description": "Normalized form (lowercase, hyphenated)"
}
},
"description": "A user-applied tag on an eprint"
},
"authorRef": {
"type": "object",
"required": [
"did"
],
"properties": {
"did": {
"type": "string",
"format": "did",
"description": "Author DID"
},
"avatar": {
"type": "string",
"format": "uri",
"description": "Avatar URL"
},
"handle": {
"type": "string",
"description": "Author handle"
},
"displayName": {
"type": "string",
"description": "Display name"
}
},
"description": "Reference to an author"
},
"tagSuggestion": {
"type": "object",
"required": [
"displayForm",
"normalizedForm",
"confidence",
"source"
],
"properties": {
"source": {
"type": "string",
"description": "Source of the suggestion",
"knownValues": [
"cooccurrence",
"authority",
"facet"
]
},
"confidence": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Suggestion confidence (0-100, scaled from 0-1)"
},
"displayForm": {
"type": "string",
"description": "Suggested display form"
},
"matchedTerm": {
"type": "string",
"description": "Term that triggered this suggestion"
},
"normalizedForm": {
"type": "string",
"description": "Normalized form of the suggestion"
}
},
"description": "A tag suggestion from the TaxoFolk system"
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1,
"revision": 1
}