From 37edc807480300ef5e91ee97a29dbb7c1da6948c Mon Sep 17 00:00:00 2001
From: Manan <manan@neynar.com>
Date: Mon, 18 Dec 2023 12:01:46 -0800
Subject: [PATCH] feat: add channel details API

---
 src/v2/spec.yaml | 38 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/src/v2/spec.yaml b/src/v2/spec.yaml
index 4d75741..91a6d42 100644
--- a/src/v2/spec.yaml
+++ b/src/v2/spec.yaml
@@ -476,8 +476,8 @@ components:
           type: string
         image_url:
           type: string
-        lead_fid:
-          $ref: "#/components/schemas/Fid"
+        lead:
+          $ref: "#/components/schemas/User"
     ChannelListResponse:
       type: object
       required:
@@ -487,6 +487,13 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/Channel"
+    ChannelResponse:
+      type: object
+      required:
+        - channel
+      properties:
+        channel:
+          $ref: "#/components/schemas/Channel"
     UserSearchResponse:
       type: object
       required:
@@ -1648,6 +1655,33 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/ChannelListResponse"
+  /farcaster/channel:
+    get:
+      tags:
+        - Channel
+      summary: Retrieve channel details by channel_id
+      description: Returns details of a channel
+      externalDocs:
+        url: https://docs.neynar.com/reference/channel-details
+      operationId: channel-details
+      parameters:
+        - $ref: "#/components/parameters/ApiKey"
+        - name: channel_id
+          in: query
+          required: true
+          schema:
+            type: string
+          example: "neynar"
+          description: Channel ID for the channel being queried
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ChannelResponse"
+        "404":
+          $ref: "#/components/responses/404Response"
   /farcaster/followers/relevant:
     get:
       tags: