From d6d9acc5ec5c110a72903c4a52a61894f023cdcb Mon Sep 17 00:00:00 2001
From: Bryan Marchena <bmarchena@planning.nyc.gov>
Date: Thu, 30 May 2024 08:09:22 -0400
Subject: [PATCH] Document capital projects in city council district endpoint

---
 openapi/openapi.yaml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/openapi/openapi.yaml b/openapi/openapi.yaml
index 74948b39..e9235734 100644
--- a/openapi/openapi.yaml
+++ b/openapi/openapi.yaml
@@ -111,6 +111,27 @@ paths:
           $ref: "#/components/responses/NotFound"
         '500':
           $ref: "#/components/responses/InternalServerError"
+  /city-council-districts/{cityCouncilDistrictId}/capital-projects:
+    get:
+      summary: 🚧 Find paginated capital projects within a specific city council district.
+      operationId: findCapitalProjectsByCityCouncilId
+      tags:
+        - Capital Projects
+      parameters:
+        - $ref: "#/components/parameters/cityCouncilDistrictIdParam"
+      responses:
+        '200':
+          description: An object containing pagination metadata and an array of capital projects for the city council district
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CapitalProjectPage"
+        '400':
+          $ref: "#/components/responses/BadRequest"
+        '404':
+          $ref: "#/components/responses/NotFound"
+        '500':
+          $ref: "#/components/responses/InternalServerError"
   /land-uses:
     get: 
       summary: List land uses
@@ -674,6 +695,7 @@ components:
         - managingAgencyInitials
         - minDate
         - maxDate
+        - category
     CapitalProjectPage:
       allOf:
         - $ref: '#/components/schemas/Page'