Get a single governance proposal by ID with full enrichment
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
Sending request...
View raw schema
{
"type": "query",
"errors": [
{
"name": "NotFound"
}
],
"output": {
"schema": {
"ref": "#proposalView",
"type": "ref"
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"required": [
"proposalId"
],
"properties": {
"proposalId": {
"type": "string",
"description": "Proposal identifier"
}
}
},
"description": "Get a single governance proposal by ID with full enrichment"
}
No description available.
Properties
Current approval percentage (0-100)
minimum: 0maximum: 100
Whether consensus has been reached
Minimum votes required
minimum: 0
Recommended status based on votes
Known values: approved, rejected, pending
Required threshold for approval (0-100)
minimum: 0maximum: 100
Number of voters
minimum: 0
View raw schema
{
"type": "object",
"required": [
"approvalPercentage",
"threshold",
"voterCount",
"minimumVotes",
"consensusReached",
"recommendedStatus"
],
"properties": {
"threshold": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Required threshold for approval (0-100)"
},
"voterCount": {
"type": "integer",
"minimum": 0,
"description": "Number of voters"
},
"minimumVotes": {
"type": "integer",
"minimum": 0,
"description": "Minimum votes required"
},
"consensusReached": {
"type": "boolean",
"description": "Whether consensus has been reached"
},
"recommendedStatus": {
"type": "string",
"description": "Recommended status based on votes",
"knownValues": [
"approved",
"rejected",
"pending"
]
},
"approvalPercentage": {
"type": "integer",
"maximum": 100,
"minimum": 0,
"description": "Current approval percentage (0-100)"
}
}
}
No description available.
Properties
Identifier in external system
Match type
Known values: exact, close, broader, narrower, related
View raw schema
{
"type": "object",
"required": [
"system",
"identifier"
],
"properties": {
"uri": {
"type": "string",
"format": "uri",
"description": "URI in external system"
},
"system": {
"type": "string",
"description": "External system name"
},
"matchType": {
"type": "string",
"description": "Match type",
"knownValues": [
"exact",
"close",
"broader",
"narrower",
"related"
]
},
"identifier": {
"type": "string",
"description": "Identifier in external system"
}
}
}
Proposed changes to a node
Properties
Node kind
Known values: type, object
Target URI for update/deprecate
View raw schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Node kind",
"knownValues": [
"type",
"object"
]
},
"label": {
"type": "string",
"description": "Node label"
},
"subkind": {
"type": "string",
"description": "Node subkind"
},
"metadata": {
"type": "unknown",
"description": "Additional metadata"
},
"targetUri": {
"type": "string",
"format": "at-uri",
"description": "Target URI for update/deprecate"
},
"description": {
"type": "string",
"description": "Node description"
},
"externalIds": {
"type": "array",
"items": {
"ref": "#externalId",
"type": "ref"
},
"description": "External identifiers"
},
"mergeIntoUri": {
"type": "string",
"format": "at-uri",
"description": "Merge target URI"
},
"alternateLabels": {
"type": "array",
"items": {
"type": "string"
},
"description": "Alternate labels"
}
},
"description": "Proposed changes to a node"
}
View of a governance proposal
Properties
No description available.
Node label (from target node or proposed changes)
Target node URI (for update/merge/deprecate)
Display name of the proposer
Rationale for the proposal
Current proposal status
Known values: pending, approved, rejected, expired
Proposal type
Known values: create, update, merge, deprecate
No description available.
View raw schema
{
"type": "object",
"required": [
"id",
"uri",
"cid",
"type",
"changes",
"status",
"proposedBy",
"votes",
"consensus",
"createdAt"
],
"properties": {
"id": {
"type": "string",
"description": "Proposal identifier"
},
"cid": {
"type": "string",
"description": "Content identifier"
},
"uri": {
"type": "string",
"format": "at-uri",
"description": "Proposal AT-URI"
},
"type": {
"type": "string",
"description": "Proposal type",
"knownValues": [
"create",
"update",
"merge",
"deprecate"
]
},
"label": {
"type": "string",
"description": "Node label (from target node or proposed changes)"
},
"votes": {
"ref": "#voteCounts",
"type": "ref"
},
"status": {
"type": "string",
"description": "Current proposal status",
"knownValues": [
"pending",
"approved",
"rejected",
"expired"
]
},
"changes": {
"ref": "#proposalChanges",
"type": "ref",
"description": "Proposed changes"
},
"nodeUri": {
"type": "string",
"format": "at-uri",
"description": "Target node URI (for update/merge/deprecate)"
},
"consensus": {
"ref": "#consensusProgress",
"type": "ref"
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "Creation timestamp"
},
"expiresAt": {
"type": "string",
"format": "datetime",
"description": "Expiration timestamp"
},
"rationale": {
"type": "string",
"description": "Rationale for the proposal"
},
"updatedAt": {
"type": "string",
"format": "datetime",
"description": "Last update timestamp"
},
"proposedBy": {
"type": "string",
"format": "did",
"description": "DID of the proposer"
},
"proposerName": {
"type": "string",
"description": "Display name of the proposer"
}
},
"description": "View of a governance proposal"
}
No description available.
Properties
Number of abstain votes
minimum: 0
Number of approve votes
minimum: 0
Number of reject votes
minimum: 0
View raw schema
{
"type": "object",
"required": [
"approve",
"reject",
"abstain"
],
"properties": {
"reject": {
"type": "integer",
"minimum": 0,
"description": "Number of reject votes"
},
"abstain": {
"type": "integer",
"minimum": 0,
"description": "Number of abstain votes"
},
"approve": {
"type": "integer",
"minimum": 0,
"description": "Number of approve votes"
}
}
}