pub.chive.governance.getUserVote

chive.pub View official

Documentation

Get a user's vote on a specific proposal, if they have voted

main query

Get a user's vote on a specific proposal, if they have voted

Parameters

proposalId string Required

Proposal identifier

userDid string did Required

User DID

Output

Encodingapplication/json
vote union Required

Vote if found, or null

Errors

NotFound
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Proposal identifier
User DID
View raw schema 
{
  "description": "Get a user's vote on a specific proposal, if they have voted",
  "errors": [
    {
      "name": "NotFound"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "vote": {
          "description": "Vote if found, or null",
          "refs": [
            "#voteView"
          ],
          "type": "union"
        }
      },
      "required": [
        "vote"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "proposalId": {
        "description": "Proposal identifier",
        "type": "string"
      },
      "userDid": {
        "description": "User DID",
        "format": "did",
        "type": "string"
      }
    },
    "required": [
      "proposalId",
      "userDid"
    ],
    "type": "params"
  },
  "type": "query"
}
voteView object

View of a vote on a proposal

Properties

cid string Required

Content identifier

createdAt string datetime Required

Vote timestamp

id string Required

Vote identifier

proposalUri string at-uri Required

Proposal AT-URI

rationale string Optional

Vote rationale

uri string at-uri Required

Vote AT-URI

vote string Required

Vote value

Known values: approve, reject, abstain, request-changes
voterDid string did Required

Voter DID

voterRole string Required

Voter governance role

Known values: community-member, reviewer, domain-expert, administrator
weight integer Required

Weighted vote value (scaled by 1000 for 0.0-1.0 range)

minimum: 0maximum: 1000
View raw schema 
{
  "description": "View of a vote on a proposal",
  "properties": {
    "cid": {
      "description": "Content identifier",
      "type": "string"
    },
    "createdAt": {
      "description": "Vote timestamp",
      "format": "datetime",
      "type": "string"
    },
    "id": {
      "description": "Vote identifier",
      "type": "string"
    },
    "proposalUri": {
      "description": "Proposal AT-URI",
      "format": "at-uri",
      "type": "string"
    },
    "rationale": {
      "description": "Vote rationale",
      "type": "string"
    },
    "uri": {
      "description": "Vote AT-URI",
      "format": "at-uri",
      "type": "string"
    },
    "vote": {
      "description": "Vote value",
      "knownValues": [
        "approve",
        "reject",
        "abstain",
        "request-changes"
      ],
      "type": "string"
    },
    "voterDid": {
      "description": "Voter DID",
      "format": "did",
      "type": "string"
    },
    "voterRole": {
      "description": "Voter governance role",
      "knownValues": [
        "community-member",
        "reviewer",
        "domain-expert",
        "administrator"
      ],
      "type": "string"
    },
    "weight": {
      "description": "Weighted vote value (scaled by 1000 for 0.0-1.0 range)",
      "maximum": 1000,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "id",
    "uri",
    "cid",
    "proposalUri",
    "voterDid",
    "voterRole",
    "vote",
    "weight",
    "createdAt"
  ],
  "type": "object"
}

Lexicon Garden

@