pub.chive.governance.listProposals
List governance proposals with optional filtering by status, type, and other criteria
Details · query
| Kind | query |
|---|---|
| Authority | governance.chive.pub |
| Indexed |
Query
query · GETParameters
query stringcursor
stringPagination cursor for next page
kind
stringFilter by node kind
knownValues: type | object
limit
integerMaximum number of results to return
minimum: 1maximum: 100default: 50
nodeUri
string · at-uriFilter by target node URI
proposedBy
string · didFilter by proposer DID
status
stringFilter by proposal status
knownValues: pending | approved | rejected | expired
subkind
stringFilter by subkind (field, institution, etc.)
type
stringFilter by proposal type
knownValues: create | update | merge | deprecate
Output
application/jsoncursor
stringCursor for next page
List of proposals
Total number of proposals matching filters
#consensusProgress
objectProperties
Current approval percentage (0-100)
minimum: 0maximum: 100
Whether consensus has been reached
Minimum votes required
minimum: 0
Recommended status based on votes
knownValues: approved | rejected | pending
Required threshold for approval (0-100)
minimum: 0maximum: 100
Number of voters
minimum: 0
#externalId
object#proposalChanges
objectProposed changes to a node
Properties
alternateLabels
arrayAlternate labels
description
stringNode description
externalIds
arrayExternal identifiers
kind
stringNode kind
knownValues: type | object
label
stringNode label
mergeIntoUri
string · at-uriMerge target URI
metadata
unknownAdditional metadata
subkind
stringNode subkind
targetUri
string · at-uriTarget URI for update/deprecate
#proposalView
objectView of a governance proposal
Properties
Proposed changes
Content identifier
Creation timestamp
expiresAt
string · datetimeExpiration timestamp
Proposal identifier
label
stringNode label (from target node or proposed changes)
nodeUri
string · at-uriTarget node URI (for update/merge/deprecate)
DID of the proposer
proposerName
stringDisplay name of the proposer
rationale
stringRationale for the proposal
Current proposal status
knownValues: pending | approved | rejected | expired
Proposal type
knownValues: create | update | merge | deprecate
updatedAt
string · datetimeLast update timestamp
Proposal AT-URI
#voteCounts
objectSimilar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Get a single governance proposal by ID with full enrichment
-
List votes for a specific governance proposal
-
Get the count of pending governance proposals, used for notification badges
-
List knowledge graph nodes with optional filtering by kind, subkind, and status
-
Get a user's vote on a specific proposal, if they have voted