/api/control-plane (dashboard)

This is the dashboard service route. Its origin and authentication are described in Platform API overview and Authentication. A path shared by another service is a different endpoint.

Authentication and access

Dashboard session cookie through @repo/auth/server. Some auth-summary routes can redirect to sign-in; inspect the status branches below.

Method behavior

The handler excerpt preserves field validation, response envelopes, cookie changes, and exception branches. Values returned by service helpers retain their named response type above; for passthrough routes, the upstream response is authoritative.

GET

export async function GET(request: NextRequest) {
  return handleControlPlaneRequest(request);
}

Source: minds-ui/apps/app/app/api/control-plane/route.ts:14.

POST

export async function POST(request: NextRequest) {
  return handleControlPlaneRequest(request);
}

Source: minds-ui/apps/app/app/api/control-plane/route.ts:18.

PUT

export async function PUT(request: NextRequest) {
  return handleControlPlaneRequest(request);
}

Source: minds-ui/apps/app/app/api/control-plane/route.ts:22.

PATCH

export async function PATCH(request: NextRequest) {
  return handleControlPlaneRequest(request);
}

Source: minds-ui/apps/app/app/api/control-plane/route.ts:26.

DELETE

export async function DELETE(request: NextRequest) {
  return handleControlPlaneRequest(request);
}

Source: minds-ui/apps/app/app/api/control-plane/route.ts:30.

HEAD

export async function HEAD(request: NextRequest) {
  return handleControlPlaneRequest(request);
}

Source: minds-ui/apps/app/app/api/control-plane/route.ts:34.

Response and error branches

Literal HTTP statuses in the route: 200, 400, 401, 502, 503. Shared management error classes are defined in Errors and responses.

NextResponse.json(
      { error: { code: 'UNAUTHENTICATED', message: 'Sign in at auth.l1fe.ai before using Minds.' } },
      { status: 401 }
    )

Source: minds-ui/apps/app/app/api/control-plane/route.ts:41.

NextResponse.json(
      { error: { code: 'INVALID_CONTROL_PLANE_PATH', message: 'Control-plane path is required.' } },
      { status: 400 }
    )

Source: minds-ui/apps/app/app/api/control-plane/route.ts:49.

NextResponse.json(
      { error: { code: 'CONTROL_PLANE_UNCONFIGURED', message: 'Control-plane API is not configured.' } },
      { status: 503, headers: noStoreHeaders() }
    )

Source: minds-ui/apps/app/app/api/control-plane/route.ts:60.

NextResponse.json(
      { error: { code: 'CONTROL_PLANE_UPSTREAM_UNAVAILABLE', message } },
      { status: 502, headers: noStoreHeaders() }
    )

Source: minds-ui/apps/app/app/api/control-plane/route.ts:82.

NextResponse.json(fallback, { status: 200, headers: noStoreHeaders() })

Source: minds-ui/apps/app/app/api/control-plane/route.ts:159.

Evidence

Generated from the local source snapshot on 2026-09-12. This page documents implemented code and does not certify a deployed service, permissions configuration, or successful provider operation.

Source file: minds-ui/apps/app/app/api/control-plane/route.ts. SHA-256: a7b990c04007ce107f441764552a9b9515246d6d4218e78cf191576853653144.