/api/instance-context/active (dashboard)
Source-derived dashboard endpoint contract, authentication, request validation, responses, and errors.
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.
| Property | Contract |
|---|---|
| Methods | POST, GET |
| Path | /api/instance-context/active |
| Path parameters | None |
| Query parameters read in route | None read directly; schema validation below may define additional fields |
| Headers read in route | No additional direct header reads; authentication helpers may read credentials |
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.
POST
export async function POST(request: NextRequest) {
try {
const { userId, redirectToSignIn } = await auth();
if (!userId) {
return redirectToSignIn();
}
const body = await request.json();
const { serviceId } = body;
if (!serviceId || typeof serviceId !== 'string') {
return NextResponse.json(
{ error: { code: 'INVALID_REQUEST', message: 'serviceId is required' } },
{ status: 400 }
);
}
// Set cookie with secure attributes
const cookieStore = await cookies();
cookieStore.set(COOKIE_NAME, serviceId, {
httpOnly: true,
secure: process.env.NODE_ENV === 'production',
sameSite: 'lax',
maxAge: COOKIE_MAX_AGE,
path: '/',
});
return NextResponse.json({ success: true, serviceId });
} catch (error) {
console.error('Failed to set active service:', error);
return NextResponse.json(
{
error: {
code: 'SET_FAILED',
message: error instanceof Error ? error.message : 'Failed to set active service',
},
},
{ status: 500 }
);
}
}Source: minds-ui/apps/app/app/api/instance-context/active/route.ts:17.
GET
export async function GET(request: NextRequest) {
try {
const { userId, redirectToSignIn } = await auth();
if (!userId) {
return redirectToSignIn();
}
const cookieStore = await cookies();
const activeServiceId = cookieStore.get(COOKIE_NAME)?.value || null;
return NextResponse.json({ serviceId: activeServiceId });
} catch (error) {
console.error('Failed to get active service:', error);
return NextResponse.json(
{
error: {
code: 'GET_FAILED',
message: error instanceof Error ? error.message : 'Failed to get active service',
},
},
{ status: 500 }
);
}
}Source: minds-ui/apps/app/app/api/instance-context/active/route.ts:65.
Response and error branches
Literal HTTP statuses in the route: 400, 500. Shared management error classes are defined in Errors and responses.
request.json()Source: minds-ui/apps/app/app/api/instance-context/active/route.ts:25.
NextResponse.json(
{ error: { code: 'INVALID_REQUEST', message: 'serviceId is required' } },
{ status: 400 }
)Source: minds-ui/apps/app/app/api/instance-context/active/route.ts:29.
NextResponse.json({ success: true, serviceId })Source: minds-ui/apps/app/app/api/instance-context/active/route.ts:45.
NextResponse.json(
{
error: {
code: 'SET_FAILED',
message: error instanceof Error ? error.message : 'Failed to set active service',
},
},
{ status: 500 }
)Source: minds-ui/apps/app/app/api/instance-context/active/route.ts:49.
NextResponse.json({ serviceId: activeServiceId })Source: minds-ui/apps/app/app/api/instance-context/active/route.ts:76.
NextResponse.json(
{
error: {
code: 'GET_FAILED',
message: error instanceof Error ? error.message : 'Failed to get active service',
},
},
{ status: 500 }
)Source: minds-ui/apps/app/app/api/instance-context/active/route.ts:80.
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/instance-context/active/route.ts. SHA-256: 02a6326563947ed5724911c50d01aab64fa89435ee7d2438552066de8a55f13f.