fix openapi

Author: steven-tey

apps/web/lib/openapi/commissions/update-commission.ts

@@ -9,6 +9,9 @@ export const updateCommission: ZodOpenApiOperationObject = {
   summary: "Update a commission.",
   description:
     "Update an existing commission amount. This is useful for handling refunds (partial or full) or fraudulent sales.",
+  requestParams: {
+    path: CommissionSchema.pick({ id: true }),
+  },
   requestBody: {
     content: {
       "application/json": {

apps/web/lib/zod/schemas/commissions.ts

@@ -7,7 +7,9 @@ import { PartnerSchema } from "./partners";
 import { parseDateSchema } from "./utils";
 
 export const CommissionSchema = z.object({
-  id: z.string(),
+  id: z.string().describe("The commission's unique ID on Dub.").openapi({
+    example: "cm_1JVR7XRCSR0EDBAF39FZ4PMYE",
+  }),
   type: z.enum(["click", "lead", "sale"]).optional(),
   amount: z.number(),
   earnings: z.number(),