The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.
TypeScript clickhousemysqlnextjsopen-sourceplanetscaleprismatailwindcsstinybirdtypescriptupstashvercel
import { createId } from "@/lib/api/create-id";
import { getLinkOrThrow } from "@/lib/api/links/get-link-or-throw";
import { withWorkspace } from "@/lib/auth";
import { verifyFolderAccess } from "@/lib/folder/permissions";
import { getPlanCapabilities } from "@/lib/plan-capabilities";
import { prisma } from "@/lib/prisma";
import {
createDashboardQuerySchema,
dashboardSchema,
} from "@/lib/zod/schemas/dashboard";
import { waitUntil } from "@vercel/functions";
import { NextResponse } from "next/server";
import * as z from "zod/v4";
// GET /api/dashboards – get all dashboards
export const GET = withWorkspace(
async ({ workspace }) => {
const dashboards = await prisma.dashboard.findMany({
where: { projectId: workspace.id },
});
return NextResponse.json(z.array(dashboardSchema).parse(dashboards));
},
{
requiredPermissions: ["links.read"],
},
);
// POST /api/dashboards – create a new dashboard
export const POST = withWorkspace(
async ({ searchParams, workspace, session }) => {
const params = createDashboardQuerySchema.parse(searchParams);
const { canTrackConversions } = getPlanCapabilities(workspace.plan);
if ("linkId" in params || ("domain" in params && "key" in params)) {
const link = await getLinkOrThrow({
workspaceId: workspace.id,
...("linkId" in params
? { linkId: params.linkId }
: "domain" in params && "key" in params
? { domain: params.domain, key: params.key }
: {}),
});
if (link.folderId) {
await verifyFolderAccess({
workspace,
userId: session.user.id,
folderId: link.folderId,
requiredPermission: "folders.links.write",
});
}
const dashboard = await prisma.dashboard.create({
data: {
id: createId({ prefix: "dash_" }),
linkId: link.id,
projectId: workspace.id,
userId: link.userId,
showConversions: canTrackConversions,
},
});
// for backwards compatibility, we'll update the link to have publicStats = true
waitUntil(
prisma.link.update({
where: { id: link.id },
data: { publicStats: true },
}),
);
return NextResponse.json(dashboardSchema.parse(dashboard));
} else {
const { folderId } = params;
await verifyFolderAccess({
workspace,
userId: session.user.id,
folderId: folderId,
requiredPermission: "folders.links.write",
});
const dashboard = await prisma.dashboard.create({
data: {
id: createId({ prefix: "dash_" }),
folderId,
projectId: workspace.id,
userId: session.user.id,
showConversions: canTrackConversions,
},
});
waitUntil(
prisma.link.updateMany({
where: { folderId },
data: { publicStats: true },
}),
);
return NextResponse.json(dashboardSchema.parse(dashboard));
}
},
{
requiredPermissions: ["links.write"],
},
);