At this level
pub.chive · 5- pub.chive.activity.getCorrelationMetrics query Get activity correlation metrics showing confirmation rates, latencies, and error counts by category (admin only)
- pub.chive.activity.getFeed query Get the authenticated user's activity feed with pagination
- pub.chive.activity.log procedure Log a user-initiated write action before performing PDS write. The activity is stored with status='pending' until the firehose event is received and correlated.
- pub.chive.activity.markFailed procedure Mark a pending activity as failed when PDS write fails
- pub.chive.actor.autocompleteAffiliation query Autocomplete institutional affiliations using the Research Organization Registry (ROR) API
- pub.chive.actor.autocompleteKeyword query Autocomplete research keywords using FAST subject headings and Wikidata entities
- pub.chive.actor.autocompleteOpenReview query Autocomplete OpenReview profiles (proxied since OpenReview API does not support CORS)
- pub.chive.actor.autocompleteOrcid query Autocomplete ORCID profiles for author verification
- pub.chive.actor.discoverAuthorIds query Discover external author IDs (OpenAlex, Semantic Scholar, etc.) by searching for a name across academic databases
- pub.chive.actor.getDiscoverySettings query Get the authenticated user's discovery settings from their PDS
- pub.chive.actor.getMyProfile query Get the authenticated user's Chive profile from their PDS
- pub.chive.actor.getMyRoles query Get the authenticated user's roles and access flags
- pub.chive.actor.getProfileConfig query Get profile configuration for a user
- pub.chive.actor.listMutes query not from the namespace authority List the authors the authenticated user has muted. Reads the index built from the user's own pub.chive.actor.mute records, so the list follows the user between devices rather than living in one browser.
- pub.chive.actor.mute record Mute an author to hide their content from feeds
- pub.chive.actor.profile record Chive-specific author profile
- pub.chive.actor.profileConfig record not from the namespace authority How an author's profile page is arranged: which sections appear, in what order, and which collection is featured. Written by the account holder to their own repository.
- pub.chive.admin.assignRole procedure Assign a role to a user
- pub.chive.admin.cancelBackfill procedure Cancel a running backfill operation
- pub.chive.admin.deleteContent procedure Soft-delete content from the index by URI and collection
- pub.chive.admin.dismissDLQEntry procedure Remove a single DLQ entry without retrying
- pub.chive.admin.getActivityCorrelation query Get activity correlation metrics across content types
- pub.chive.admin.getAuditLog query Get admin audit log entries
- pub.chive.admin.getBackfillHistory query Get history of completed, failed, and cancelled backfill operations
- pub.chive.admin.getBackfillStatus query Get status of backfill operations
- pub.chive.admin.getEndpointMetrics query Get per-endpoint HTTP request metrics from Prometheus
- pub.chive.admin.getFirehoseStatus query Get firehose cursor position and DLQ status
- pub.chive.admin.getGraphStats query Get knowledge graph statistics
- pub.chive.admin.getMetricsOverview query Get metrics overview with trending eprints for a given period
- pub.chive.admin.getNodeMetrics query Get Node.js runtime metrics and process information
- pub.chive.admin.getOverview query Get aggregate counts from all index tables
- pub.chive.admin.getPrometheusMetrics query Get Prometheus metrics as JSON
- pub.chive.admin.getSearchAnalytics query Get search usage analytics
- pub.chive.admin.getSystemHealth query Get health status of all database connections
- pub.chive.admin.getTrendingVelocity query Get trending eprints ranked by engagement velocity
- pub.chive.admin.getUserDetail query Get detailed information about a specific user
- pub.chive.admin.getViewDownloadTimeSeries query Get view and download time series data
- pub.chive.admin.listDLQEntries query List entries from the firehose dead-letter queue
- pub.chive.admin.listEndorsements query List indexed endorsements with pagination
- pub.chive.admin.listEprints query List indexed eprints with pagination
- pub.chive.admin.listImports query List imported eprint statistics
- pub.chive.admin.listPDSes query List known PDSes and their statistics
- pub.chive.admin.listReviews query List indexed reviews with pagination
- pub.chive.admin.listViolations query List policy violations
- pub.chive.admin.listWarnings query List user warnings
- pub.chive.admin.purgeOldDLQ procedure Purge DLQ entries older than a specified number of days
- pub.chive.admin.rescanPDS procedure Trigger a rescan of a specific PDS
- pub.chive.admin.retryAllDLQ procedure Batch retry all DLQ entries, optionally filtered by error type
- pub.chive.admin.retryDLQEntry procedure Requeue a single DLQ entry for reprocessing
- pub.chive.admin.revokeRole procedure Revoke a role from a user
- pub.chive.admin.searchUsers query Search users by handle or DID
- pub.chive.admin.triggerBackfill procedure Trigger a backfill operation by type
- pub.chive.admin.triggerCitationExtraction procedure Trigger citation extraction for indexed eprints
- pub.chive.admin.triggerDIDSync procedure Trigger a full repository sync for a specific DID
- pub.chive.admin.triggerFreshnessScan procedure Trigger a freshness scan to detect stale indexed records
- pub.chive.admin.triggerFullReindex procedure Trigger a full Elasticsearch reindex of all indexed records
- pub.chive.admin.triggerGovernanceSync procedure Trigger a sync of governance records from the Governance PDS
- pub.chive.admin.triggerPDSScan procedure Trigger a scan of known PDSes for new records
- pub.chive.annotation.comment record Inline annotation on a specific text span in an eprint
- pub.chive.annotation.entityLink record Link from a text span in an eprint to a knowledge graph entity
- pub.chive.annotation.getThread query Get an annotation thread including the root annotation and all replies
- pub.chive.annotation.listByAuthor query List annotations created by a specific author
- pub.chive.annotation.listForEprint query List annotations for a specific eprint with optional filtering
- pub.chive.annotation.listForPage query List annotations for a specific page in an eprint
- pub.chive.author.getProfile query Get author profile and metrics by DID
- pub.chive.author.initiateOrcidVerification procedure Initiate ORCID OAuth verification flow. Returns a URL to redirect the user to ORCID for authentication. Requires authentication.
- pub.chive.author.searchAuthors query Search for authors by name or other criteria
- pub.chive.backlink.create procedure Create a backlink record. Internal/plugin use only. Requires authentication.
- pub.chive.backlink.delete procedure Delete (mark as deleted) a backlink record. Internal/plugin use only. Requires authentication.
- pub.chive.backlink.getCounts query Get aggregated backlink counts for an eprint
- pub.chive.backlink.list query List backlinks to an eprint from ATProto ecosystem sources including Cosmik collections, Leaflet lists, Whitewind blogs, and Bluesky shares
- pub.chive.claiming.approveClaim procedure Approve a pending claim request. Admin only.
- pub.chive.claiming.approveCoauthor procedure Approve a pending co-author request. Only the eprint owner can approve.
- pub.chive.claiming.autocomplete query Provides fast autocomplete suggestions for claiming search. Optimized for low latency with short timeouts.
- pub.chive.claiming.completeClaim procedure Complete a claim after the user creates their canonical record in their PDS. Requires authentication and claimant ownership.
- pub.chive.claiming.dismissSuggestion procedure not from the namespace authority Record that the authenticated user does not want to see a particular paper suggestion. The paper is filtered out of future suggestions.
- pub.chive.claiming.fetchExternalPdf query Fetch external PDF through proxy to avoid CORS issues. Returns PDF binary data. Only allows fetching from trusted academic sources.
- pub.chive.claiming.findClaimable query Find claimable eprints matching the user's identity or search criteria. Requires authentication.
- pub.chive.claiming.getClaim query Get a claim request by ID. Users can only view their own claims unless they are admins.
- pub.chive.claiming.getCoauthorRequests query Get pending co-author requests for the authenticated user's eprints. Returns requests where the user is the eprint owner.
- pub.chive.claiming.getMyCoauthorRequests query Get co-author requests made by the authenticated user. Returns requests where the user is the claimant.
- pub.chive.claiming.getPendingClaims query Get pending claims for admin review. Admin only.
- pub.chive.claiming.getSubmissionData query Get prefilled form data for claiming a paper from an external source
- pub.chive.claiming.getSuggestions query Get suggested papers for the authenticated user to claim based on their profile
- pub.chive.claiming.getUserClaims query Get claims for the authenticated user
- pub.chive.claiming.rejectClaim procedure Reject a pending claim with a reason. Admin only.
- pub.chive.claiming.rejectCoauthor procedure Reject a pending co-author request. Only the PDS owner can reject.
- pub.chive.claiming.requestCoauthorship procedure Request co-authorship on an existing eprint in another user's PDS
- pub.chive.claiming.searchEprints query Search external eprint sources for papers to claim
- pub.chive.claiming.startClaim procedure Initiate a claim request for an imported eprint
- pub.chive.claiming.startClaimFromExternal procedure Start a claim directly from an external search result, importing on demand if needed
- pub.chive.collaboration.invite record Invitation record from a subject-record author to a potential collaborator. Lives in the inviter's PDS. Generic over any Chive record (collections in v1; eprints, reviews, and other records in the future).
- pub.chive.collaboration.inviteAcceptance record Acceptance record created by an invitee, acknowledging a collaboration invite. Lives in the invitee's PDS. The combination of an existing invite and a matching acceptance — both non-deleted — is what grants the invitee's writes to be surfaced against the subject record.
- pub.chive.collaboration.listCollaborators query List active collaborators on a subject record (DIDs that have both a non-deleted invite from the subject's author and a non-deleted acceptance of that invite).
- pub.chive.collaboration.listInvites query List collaboration invites, filtered by invitee, inviter, and/or subject. Typically used to populate an invitee's inbox.
- pub.chive.collection.defs defs Reference to a collection item that triggered a feed event
- pub.chive.collection.findContainsEdge query Find the CONTAINS edge between a collection and an item
- pub.chive.collection.get query Get a single collection by its AT-URI
- pub.chive.collection.getContaining query Get collections that contain a specific item
- pub.chive.collection.getFeed query Get the activity feed for a collection, aggregating events from tracked items
- pub.chive.collection.getFollowStatus query Check if a user follows a collection (via network.cosmik.follow records)
- pub.chive.collection.getFollowerCount query Get the follower count for a collection (via network.cosmik.follow records)
- pub.chive.collection.getMarginAnnotations query Get Margin annotations (at.margin.annotation, at.margin.highlight) targeting a Chive eprint
- pub.chive.collection.getParent query Get the parent collection of a given collection
- pub.chive.collection.getSubcollections query Get subcollections of a given collection
- pub.chive.collection.listByOwner query List collections owned by a specific user
- pub.chive.collection.listPublic query List publicly visible collections with optional tag filtering
- pub.chive.collection.search query Search collections by query string
- pub.chive.discovery.getCitations query Get citation network data for an eprint, including papers that cite it and papers it references (within the Chive index)
- pub.chive.discovery.getEnrichment query Get enrichment data for an eprint (citations, concepts, topics)
- pub.chive.discovery.getSimilar query Get related papers for an eprint based on citation patterns, semantic similarity, and topic overlap. Supports graph-based analysis including co-citation and bibliographic coupling.
- pub.chive.discovery.recordInteraction procedure Record a user interaction with a recommendation for the feedback loop. Used to improve personalization over time.
- pub.chive.discovery.settings record User discovery preferences for personalized recommendations
- pub.chive.endorsement.getSummary query Get endorsement summary (counts by contribution type) for an eprint
- pub.chive.endorsement.getUserEndorsement query Get a user's endorsement for a specific eprint
- pub.chive.endorsement.listForAuthorPapers query List endorsements received on an author's papers
- pub.chive.endorsement.listForEprint query List endorsements for a specific eprint with optional filtering
- pub.chive.endorsement.listForUser query List endorsements given by a specific user
- pub.chive.eprint.authorContribution object Author entry with full contribution metadata
- pub.chive.eprint.changelog record Structured changelog entry for eprint version
- pub.chive.eprint.citation record User-curated citation linking an eprint to a cited work
- pub.chive.eprint.deleteSubmission procedure Delete an eprint submission from the user's PDS
- pub.chive.eprint.getChangelog query Get a specific changelog entry by URI
- pub.chive.eprint.getSubmission query Retrieve an eprint submission by URI
- pub.chive.eprint.listByAuthor query List eprints by author DID
- pub.chive.eprint.listChangelogs query List all changelog entries for an eprint
- pub.chive.eprint.listCitations query List citations for an eprint (auto-extracted and user-provided)
- pub.chive.eprint.listDataLinks query not from the namespace authority List Layers datasets linked to an eprint. Chive does not index pub.layers.eprint.dataLink records; it asks the Layers AppView, which is authoritative for them, and caches the answer briefly. Returns an empty list when Layers is unreachable, so an eprint page never depends on another service being up.
- pub.chive.eprint.listRelatedWorks query List user-curated related works for an eprint
- pub.chive.eprint.relatedWork record User-curated related paper link between eprints
- pub.chive.eprint.searchSubmissions query Search preprints with faceted filters using knowledge graph dimensions
- pub.chive.eprint.submission record A scholarly eprint submission record
- pub.chive.eprint.updateSubmission procedure Update an eprint submission with a new version
- pub.chive.eprint.userTag record User-generated tag on eprint (TaxoFolk) with optional knowledge graph linking
- pub.chive.eprint.version record Eprint version metadata
- pub.chive.governance.approveElevation procedure Approve a pending elevation request. Only accessible by administrators.
- pub.chive.governance.getEditorStatus query Get the trusted editor status and reputation metrics for a user
- pub.chive.governance.getPendingCount query Get the count of pending governance proposals, used for notification badges
- pub.chive.governance.getProposal query Get a single governance proposal by ID with full enrichment
- pub.chive.governance.getUserVote query Get a user's vote on a specific proposal, if they have voted
- pub.chive.governance.grantDelegation procedure Grant PDS delegation to a trusted editor. Only accessible to administrators. Delegation allows the user to write records to the Governance PDS.
- pub.chive.governance.listDelegations query List active PDS delegations. Only accessible by administrators.
- pub.chive.governance.listElevationRequests query List pending elevation requests for admin review. Only accessible by administrators.
- pub.chive.governance.listProposals query List governance proposals with optional filtering by status, type, and other criteria
- pub.chive.governance.listTrustedEditors query List all users with trusted editor or higher roles (admin only)
- pub.chive.governance.listVotes query List votes for a specific governance proposal
- pub.chive.governance.rejectElevation procedure Reject a pending elevation request. Only accessible by administrators.
- pub.chive.governance.requestElevation procedure Request elevation to trusted editor role. The request is validated against eligibility criteria.
- pub.chive.governance.revokeDelegation procedure Revoke an active PDS delegation. Only accessible to administrators.
- pub.chive.governance.revokeRole procedure Revoke a user's governance role. Only accessible to administrators. Also revokes any active delegation.
- pub.chive.graph.browseFaceted query Browse eprints using dynamic faceted classification from the knowledge graph
- pub.chive.graph.edge record Typed relationship between knowledge graph nodes. Relation types are themselves nodes with subkind=relation.
- pub.chive.graph.edgeProposal record Proposal for creating, updating, or deprecating edges between knowledge graph nodes (stored in user PDS)
- pub.chive.graph.expandSubgraph query Expand a subgraph from root URIs using breadth-first search, returning discovered nodes and edges.
- pub.chive.graph.getCommunities query Detect communities in the knowledge graph using graph clustering algorithms
- pub.chive.graph.getEdge query Retrieve a knowledge graph edge by AT-URI
- pub.chive.graph.getHierarchy query Get hierarchical tree structure for nodes of a specific subkind
- pub.chive.graph.getNode query Retrieve a unified knowledge graph node by ID
- pub.chive.graph.getRelations query List available relation types (nodes with subkind=relation)
- pub.chive.graph.getSubkinds query List available subkind type nodes (nodes with subkind=subkind)
- pub.chive.graph.listEdges query List knowledge graph edges with optional filtering
- pub.chive.graph.listNodes query List knowledge graph nodes with optional filtering by kind, subkind, and status
- pub.chive.graph.listPersonalEdgeTypes query List available edge types for personal graph relationships
- pub.chive.graph.listPersonalNodes query List personal graph nodes for the authenticated user
- pub.chive.graph.node record Unified knowledge graph node combining concepts, organizations, authorities, fields, and facets. All relationships are via edges.
- pub.chive.graph.nodeProposal record Unified proposal for creating, updating, merging, or deprecating knowledge graph nodes (stored in user PDS)
- pub.chive.graph.reconciliation record Entity reconciliation record linking local entities to external authorities
- pub.chive.graph.searchNodes query Full-text search for knowledge graph nodes with optional filtering
- pub.chive.graph.vote record Vote on field proposal
- pub.chive.metrics.getMetrics query Get comprehensive metrics for an eprint
- pub.chive.metrics.getTrending query Get trending eprints based on view counts within a time window
- pub.chive.metrics.getViewCount query Get simple view count for an eprint
- pub.chive.metrics.recordDownload procedure Record a download event for an eprint
- pub.chive.metrics.recordDwellTime procedure Record dwell time for a clicked search result (called via beacon API)
- pub.chive.metrics.recordSearchClick procedure Record a click event on a search result for LTR training data
- pub.chive.metrics.recordSearchDownload procedure Record a download event from a search result (strong positive relevance signal)
- pub.chive.metrics.recordView procedure Record a view event for an eprint
- pub.chive.review.comment record Review comment on preprint with rich body supporting text and node references
- pub.chive.review.endorsement record Endorsement of one or more contribution types in a preprint
- pub.chive.review.entityLink record Link from a text span in a preprint to a knowledge graph entity
- pub.chive.review.getThread query Get a review thread including the root review and all replies
- pub.chive.review.listForAuthor query List reviews created by a specific author with optional filtering
- pub.chive.review.listForEprint query List reviews for a specific eprint with optional filtering
- pub.chive.subscription.getStatus query not from the namespace authority Subscriber count for an author, and whether a given reader is among them. Subscriptions are site.standard.graph.subscription records written into readers' own repositories; Chive indexes them from the firehose and neither writes nor owns them.
- pub.chive.subscription.list query not from the namespace authority The authors a reader subscribes to.
- pub.chive.sync.checkStaleness query Check if indexed data is stale compared to PDS
- pub.chive.sync.deleteRecord procedure Mark a record as deleted in Chive's index (owner or admin only)
- pub.chive.sync.indexRecord procedure Index a record from PDS (owner or admin only)
- pub.chive.sync.refreshRecord procedure Refresh a stale record from PDS
- pub.chive.sync.registerPDS procedure Register a PDS for scanning to ensure records from non-relay PDSes can be discovered and indexed
- pub.chive.sync.verify query Verify the sync state of a record
- pub.chive.tag.getDetail query Get detailed information for a specific tag
- pub.chive.tag.getSuggestions query Get tag suggestions based on a query using the TaxoFolk system
- pub.chive.tag.getTrending query Get trending tags within a specified time window
- pub.chive.tag.listEprints query List eprints that have a specific tag applied
- pub.chive.tag.listForEprint query List tags for a specific eprint with TaxoFolk suggestions
- pub.chive.tag.search query Search for tags matching a query