Operate · API module

Governance

Coordinate proposals, authority assignments, MPC ceremonies, policy decisions, and immutable governance evidence.

BUSINESS CASES

Where this module fits

  • multi-party approvals
  • authority lifecycle management
  • policy and risk acceptance

PRIMARY CONSUMERS

Who integrates it

  • governance participants
  • treasury controllers
  • compliance reviewers

PREREQUISITES

What must exist first

  • governance scope and eligible role
  • current authority and policy versions

RECOMMENDED WORKFLOW

Compose the module safely.

  1. 01

    create or discover a proposal

  2. 02

    collect eligible decisions and threshold evidence

  3. 03

    verify the resulting immutable state before execution

Endpoint reference

Explore this module’s endpoints.

Check each endpoint’s availability and required permissions. Planned routes and routes awaiting deployment are preparation references, not callable APIs.

POSTAssign authority/api/v2/admin/tenants/{tenant_uuid}/authoritiesAssign TENANT_ADMIN or TENANT_MODERATOR authority with retained actor attribution and rationale.›POSTRevoke authority/api/v2/admin/tenants/{tenant_uuid}/authorities/{assignment_uuid}/revocationsRevoke an eligible tenant administrator assignment while protecting owner authority.›GETList authorities/api/v2/governance/authoritiesPlanned capability: list governance authorities and their active policy boundaries.›POSTRequest MPC ceremony/api/v2/governance/mpc-ceremoniesRequest a policy-authorized MPC ceremony from the custody boundary.›GETList proposals/api/v2/governance/proposalsList governance proposals visible to the caller.›POSTCreate proposal/api/v2/governance/proposalsCreate a policy-bound governance proposal without executing it.›GETGet proposal/api/v2/governance/proposals/{proposal_uuid}Return proposal state, authority, approvals, and retained evidence.›POSTRecord decision/api/v2/governance/proposals/{proposal_uuid}/decisionsRecord an authorized approval or rejection against a proposal.›POSTStart MPC signing/api/v2/governance/proposals/{proposal_uuid}/mpc-ceremonies/{request_uuid}/signing-sessionsStart commitment-bound threshold signing only after the pinned participant-readiness threshold is final.›GETList safes/api/v2/governance/safesPlanned capability: list governed safes available to the caller.›POSTCreate safe/api/v2/governance/safesPlanned capability: create a governed safe with explicit owners and signature threshold.›PATCHUpdate safe policy/api/v2/governance/safes/{safe_uuid}Planned capability: propose an owner or threshold change through the governed safe workflow.›POSTAnalyze authority/api/v2/contracts/{launch_uuid}/analysisAnalyze contract authority, runtime policy, and deployment prerequisites.›GETGet launch authorities/api/v2/contracts/{launch_uuid}/authoritiesReturn authority assignments and threshold status for a launch.›POSTBind governance/api/v2/contracts/{launch_uuid}/governance-bindingsBind an approved governance authority to a frozen contract launch.›GETList authority wallets/api/v2/contracts/authority-walletsList activated MPC wallets eligible for smart-contract authority roles.›GETGet execution publishing authority/api/v2/explorer/execution/publishing-authorityList execution publishing authority from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETList funding acceptance authorities/api/v2/explorer/funding/acceptance-authoritiesList funding acceptance authorities from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding acceptance authority/api/v2/explorer/funding/acceptance-authorities/{authority_identifier}Return funding acceptance authority from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding acceptance authority/api/v2/explorer/funding/acceptance-authorities/{identifier}Return funding acceptance authorities identifier from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding activation governance/api/v2/explorer/funding/activation-governanceList funding activation governance from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet funding activation policy/api/v2/explorer/funding/activation-governance/{policy_identifier}Return the current public posture for funding activation policy from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›GETGet mPC custody reserve authority/api/v2/explorer/mpc-wallets/custody-reserve-authorities/{identifier}Return mpc custody reserve authority from the public Explorer read model, with the identifiers and verification metadata defined by the live contract.›
RELATED MODULESReturn to the complete V2 directory