BUSINESS CASES
Where this module fits
- operational posture review
- exception and incident triage
- administrative workflow routing
- workload-identity administration
- least-privilege access review
- attributed reconciliation and editorial governance
v2ADMINISTRATION · MODULE 32
Provide a bounded administrative application map while keeping Identity, access, billing, newsroom, risk, review, infrastructure, and other domain controls at their authoritative services.
BUSINESS CASES
PRIMARY CONSUMERS
PREREQUISITES
RECOMMENDED WORKFLOW
discover which administrative operations are executable in live OpenAPI
establish the tenant, role, scope, and fresh step-up boundary required by the owning domain
read the narrow domain projection and retain its version and evidence references
perform only an implemented domain-specific governed action
reconcile the returned state and audit evidence instead of treating command acceptance as completion
MODULE CONTRACTS
Each operation states whether its request shape is authoritative in OpenAPI, reviewed as a planning profile, or intentionally left as an outline pending an owner schema.
/api/v2/admin/access/audit-eventsPlanned capability: list cursor-paginated security and access-control events.›POSTAssign role/api/v2/admin/access/role-assignmentsPlanned capability: create a restricted role assignment with audit evidence.›DELETERevoke role/api/v2/admin/access/role-assignments/{assignment_uuid}Planned capability: revoke a role assignment with audit evidence.›GETList roles/api/v2/admin/access/rolesPlanned capability: list restricted roles, scopes, and assignments.›POSTRevoke sessions/api/v2/admin/access/session-revocationsPlanned capability: revoke selected sessions or all sessions for an authorized subject.›GETList sessions/api/v2/admin/access/sessionsPlanned capability: list restricted active sessions and security posture.›GETGet all approved kyc submissions/api/v2/admin/approved_kycsPlanned capability: list all approved kyc submissions through the authoritative trust service boundary.›POSTSet kyc stage status/api/v2/admin/kyc_status_updatePlanned capability: apply the requested transition to set kyc stage status through the authoritative trust service boundary.›GETGet all pending kyc submissions/api/v2/admin/pending_kycsPlanned capability: list all pending kyc submissions through the authoritative trust service boundary.›POSTSet custom meta data/api/v2/admin/set_custom_meta_dataPlanned capability: apply the requested transition to set custom meta-data through the authoritative trust service boundary.›GETGet all white label transactions/api/v2/admin/transaction_listPlanned capability: list all white-label transactions through the authoritative trust service boundary.›GETGet all white label users/api/v2/admin/user_listPlanned capability: list all white-label users through the authoritative trust service boundary.›GETGet identity readiness overview/api/v2/admin/overviewReturn aggregate-only account growth, activation, onboarding, and wallet-readiness posture across 52 weekly cohorts.›GETList accounts/api/v2/admin/billing/accountsPlanned capability: list restricted customer billing accounts and reconciliation posture.›GETList events/api/v2/admin/billing/eventsPlanned capability: list restricted billing, credit, invoice, and webhook events.›POSTRun reconciliation/api/v2/admin/billing/reconciliationsPlanned capability: request an idempotent restricted billing reconciliation.›GETList workload clients/api/v2/admin/identity/workload-clientsList tenant-scoped machine identities, public keys, delegated scopes, and lifecycle state.›POSTRegister workload client/api/v2/admin/identity/workload-clientsRegister an Ed25519 workload identity using proof of possession and purpose-bound administrator step-up.›POSTRevoke workload client/api/v2/admin/identity/workload-clients/{client_id}/revocationsRevoke a workload client and immediately invalidate all of its outstanding access tokens.›POSTRotate workload client/api/v2/admin/identity/workload-clients/{client_id}/rotationsRotate a workload client's public request-signing key using old-key authorization and new-key proof of possession.›GETList articles/api/v2/admin/news/articlesList restricted draft, scheduled, and published newsroom records.›POSTCreate article/api/v2/admin/news/articlesCreate a newsroom article draft.›PATCHUpdate article/api/v2/admin/news/articles/{article_uuid}Update, schedule, publish, or archive an authorized article.›GETList contracts/api/v2/admin/prediction-marketsPlanned capability: list prediction contracts with lifecycle, oracle, exposure, dispute, and resolution-review posture.›GETGet control record/api/v2/admin/prediction-markets/{prediction_id}Planned capability: read one prediction contract's governed rules, oracle policy, exposure, disputes, and retained review evidence.›GETGet evidence/api/v2/admin/prediction-markets/{prediction_id}/evidencePlanned capability: return immutable rule, oracle, review, dispute, lifecycle, and resolution evidence for one prediction contract.›POSTRecord lifecycle decision/api/v2/admin/prediction-markets/{prediction_id}/lifecycle-decisionsPlanned capability: record a version-bound, attributed lifecycle decision without changing trading authority or traffic.›POSTRecord resolution/api/v2/admin/prediction-markets/{prediction_id}/resolutionsPlanned capability: record a governed outcome resolution bound to authoritative oracle and independent-review evidence.›GETSearch managed identities/api/v2/admin/usersSearch tenant-scoped identities and return lifecycle, deterministic risk, rating, and open-alert posture.›GETGet identity control record/api/v2/admin/users/{profile_uuid}Return one identity's lifecycle, capability controls, alerts, evidence signals, sessions, and audit events.›POSTApply identity intervention/api/v2/admin/users/{profile_uuid}/interventionsApply a version-bound lifecycle, capability, reviewer-rating, or alert decision with an attributed reason.›