From 3e09330c5f6209724da7f16f81017209b506ac03 Mon Sep 17 00:00:00 2001
From: SHUJA <shujaulisla@gmail.com>
Date: Fri, 6 Feb 2026 15:00:50 +0530
Subject: [PATCH] Update admin-openapi-1.2.59.yaml to support campaign custom
 fields: add a customFields array property to campaign filter query params,
 and introduce a new GET /v2/customfields/campaign endpoint (operationId:
 campaign-customfields-findAll) that returns available campaign custom field
 definitions (fields with _id, label, type, name, required, id, hidden,
 validation, isConsent, options, pub_hide). Includes 200 and 400 responses and
 API Key Param security.

---
 admin-openapi-1.2.59.yaml | 66 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/admin-openapi-1.2.59.yaml b/admin-openapi-1.2.59.yaml
index f19c6b4..efba8e0 100644
--- a/admin-openapi-1.2.59.yaml
+++ b/admin-openapi-1.2.59.yaml
@@ -1435,6 +1435,11 @@ paths:
                 description: Traffic channels name
                 items:
                   type: string
+              customFields:
+                type: array
+                description: List of available custom field definitions for campaigns
+                items:
+                  type: string
           in: query
           name: filters
     post:
@@ -11114,6 +11119,67 @@ paths:
               x-examples:
                 Example 1:
                   message: This is a Note
+  '/v2/customfields/campaign':
+    get:
+      summary: Get Campaign Custom Fields
+      operationId: campaign-customfields-findAll
+      tags:
+        - Campaigns
+      description: >
+        Returns the list of custom fields that can be used to filter campaigns.
+        Each custom field includes its key, label, type and any allowed values.
+      security:
+        - API Key Param: []
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  fields:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        _id:
+                          type: string
+                        label:
+                          type: string
+                        type:
+                          type: string
+                          description: Field input type (e.g. text, select)
+                        name:
+                          type: string
+                        required:
+                          type: boolean
+                        id:
+                          type: string
+                        hidden:
+                          type: boolean
+                        validation:
+                          nullable: true
+                        isConsent:
+                          type: boolean
+                        options:
+                          type: array
+                          items:
+                            type: string
+                        pub_hide:
+                          type: integer
+                          description: Visibility flag for publishers
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  errors:
+                    type: array
+                    items:
+                      $ref: ./models/error.v1.yaml
   '/v2/publishers/{pubId}/notes':
     parameters:
       - schema: