pub.chive.governance.listProposals

List governance proposals with optional filtering by status, type, and other criteria

Repository @lexicons.governance.chive.pub did:plc:egjghlwgts2hlcer2txilxeh not from the namespace authority
Details · query
Kindquery
Authoritygovernance.chive.pub
Indexed

Query

query · GET

Parameters

query string

cursor

string

Pagination cursor for next page

kind

string

Filter by node kind

  • knownValues: type | object

limit

integer

Maximum number of results to return

  • minimum: 1
  • maximum: 100
  • default: 50

nodeUri

string · at-uri

Filter by target node URI

proposedBy

string · did

Filter by proposer DID

status

string

Filter by proposal status

  • knownValues: pending | approved | rejected | expired

subkind

string

Filter by subkind (field, institution, etc.)

type

string

Filter by proposal type

  • knownValues: create | update | merge | deprecate

Output

application/json

cursor

string

Cursor for next page

proposals

requiredarray

List of proposals

itemsref
Reference

total

requiredinteger

Total number of proposals matching filters

#consensusProgress

object

Properties

approvalPercentage

requiredinteger

Current approval percentage (0-100)

  • minimum: 0
  • maximum: 100

consensusReached

requiredboolean

Whether consensus has been reached

minimumVotes

requiredinteger

Minimum votes required

  • minimum: 0

recommendedStatus

requiredstring

Recommended status based on votes

  • knownValues: approved | rejected | pending

threshold

requiredinteger

Required threshold for approval (0-100)

  • minimum: 0
  • maximum: 100

voterCount

requiredinteger

Number of voters

  • minimum: 0

#externalId

object

Properties

identifier

requiredstring

Identifier in external system

matchType

string

Match type

  • knownValues: exact | close | broader | narrower | related

system

requiredstring

External system name

uri

string · uri

URI in external system

#proposalChanges

object

Proposed changes to a node

Properties

Alternate labels

itemsstring

Node description

External identifiers

itemsref
Reference

kind

string

Node kind

  • knownValues: type | object

label

string

Node label

mergeIntoUri

string · at-uri

Merge target URI

metadata

unknown

Additional metadata

subkind

string

Node subkind

targetUri

string · at-uri

Target URI for update/deprecate

#proposalView

object

View of a governance proposal

Properties

changes

requiredref

Proposed changes

Reference

cid

requiredstring

Content identifier

consensus

requiredref
Reference

createdAt

requiredstring · datetime

Creation timestamp

expiresAt

string · datetime

Expiration timestamp

id

requiredstring

Proposal identifier

label

string

Node label (from target node or proposed changes)

nodeUri

string · at-uri

Target node URI (for update/merge/deprecate)

proposedBy

requiredstring · did

DID of the proposer

Display name of the proposer

rationale

string

Rationale for the proposal

status

requiredstring

Current proposal status

  • knownValues: pending | approved | rejected | expired

type

requiredstring

Proposal type

  • knownValues: create | update | merge | deprecate

updatedAt

string · datetime

Last update timestamp

uri

requiredstring · at-uri

Proposal AT-URI

votes

requiredref
Reference

#voteCounts

object

Properties

abstain

requiredinteger

Number of abstain votes

  • minimum: 0

approve

requiredinteger

Number of approve votes

  • minimum: 0

reject

requiredinteger

Number of reject votes

  • minimum: 0

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.