Admin-facing OSHUN BFF contract for Studio workspaces.
Base Contract#
- Base URL:
http://localhost:4010in development orNEXT_PUBLIC_OSHUN_BFF_URL - Canonical paths are available at
/admin/*with compatibility aliases at/v1/admin/* - Protected routes require
Authorization: Bearer <token> - Admin routes require one of:
admin:*admin:studioadmin:workspace:{workspaceId}
- Workspace GET routes return short-lived private cache headers and
x-oshun-cache: hit|miss
Shared Envelope#
All admin workspace routes share:
generatedAt: server timestamp for the payloaduserId: authenticated admin operator idrevision: per-user admin workspace revision counter
Workspace summaries additionally expose:
workspaceIdtitledescriptionownerTeamstatusashealthy | attention | degraded | blockedsummary.openItemssummary.urgentItemssummary.slaStatuslaunch.targetPathlaunch.shellPath
Workspace Index#
GET /admin/workspaces#
Lists the current admin workspace index for:
reviewmoderationsupportprivacypersonamodelrightsincidentpolicyanalytics
Workspace Detail#
GET /admin/workspaces/:workspaceId#
Returns one workspace-specific envelope:
review:queue,reviewers,metricsmoderation:queues,recentSimulations,metricssupport:cases,metricsprivacy:requests,metricspersona:personas,metricsmodel:models,metricsrights:requests,metricsincident:incidents,metricspolicy:policies,metricsanalytics:reports,metrics
Mutations#
Review#
POST /admin/review/items/:reviewId/assign- body:
reviewerId
- body:
POST /admin/review/items/:reviewId/decision- body:
decision=approved|rejected|changes_requested
- body:
Moderation#
POST /admin/moderation/queues/:queueId/simulations- body:
policyId,sampleSize
- body:
Support#
POST /admin/support/cases/:caseId/escalate- body:
targetTeam
- body:
Privacy#
POST /admin/privacy/requests/:requestId/resolve- body:
resolution=completed|denied
- body:
Persona#
POST /admin/personas/:personaId/publish- body:
releaseChannel=preview|staging|production - optional body:
version
- body:
Model#
POST /admin/models/:modelId/promote- body:
releaseChannel=staging|production
- body:
Rights#
POST /admin/rights/requests/:requestId/resolve- body:
resolution=fulfilled|denied
- body:
Incident#
POST /admin/incidents/:incidentId/mitigate- optional body:
commanderId
- optional body:
Policy#
POST /admin/policies/:policyId/publish
Analytics#
POST /admin/analytics/reports- body:
metricGroup=review|moderation|privacy|model|incident - body:
title
- body: