Add GET /v2/gen-ai/custom_models/{uuid} endpoint (#1171)

Author: venkatranabothu

specification/DigitalOcean-public.v2.yaml

@@ -2638,6 +2638,8 @@ paths:
 
 
   /v2/gen-ai/custom_models/{uuid}:
+    get:
+      $ref: 'resources/gen-ai/genai_get_custom_model.yml'
     delete:
       $ref: 'resources/gen-ai/genai_delete_custom_model.yml'
 

specification/resources/gen-ai/definitions.yml

@@ -3694,6 +3694,12 @@ apiGetCustomModelOutput:
     model:
       $ref: '#/apiCustomModel'
   type: object
+apiGetCustomModelOutputPublic:
+  description: Response containing a single custom model (public)
+  properties:
+    model:
+      $ref: '#/apiCustomModel'
+  type: object
 apiGetCustomModelStorageOutput:
   description: Response containing custom model storage details
   properties:

specification/resources/gen-ai/examples/curl/genai_get_custom_model.yml

@@ -0,0 +1,6 @@
+lang: cURL
+source: |-
+  curl -X GET \
+    -H "Content-Type: application/json"  \
+    -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
+    "https://api.digitalocean.com/v2/gen-ai/custom_models/11f13e07-1e4f-1325-b542-ca68c578b04b"

specification/resources/gen-ai/genai_get_custom_model.yml

@@ -0,0 +1,42 @@
+description: To retrieve details of a custom model, send a GET request to `/v2/gen-ai/custom_models/{uuid}`.
+operationId: genai_get_custom_model
+parameters:
+- description: UUID of the custom model to retrieve
+  example: '"123e4567-e89b-12d3-a456-426614174000"'
+  in: path
+  name: uuid
+  required: true
+  schema:
+    type: string
+responses:
+  "200":
+    content:
+      application/json:
+        schema:
+          $ref: ./definitions.yml#/apiGetCustomModelOutputPublic
+    description: A successful response.
+    headers:
+      ratelimit-limit:
+        $ref: ../../shared/headers.yml#/ratelimit-limit
+      ratelimit-remaining:
+        $ref: ../../shared/headers.yml#/ratelimit-remaining
+      ratelimit-reset:
+        $ref: ../../shared/headers.yml#/ratelimit-reset
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+  "404":
+    $ref: ../../shared/responses/not_found.yml
+  "429":
+    $ref: ../../shared/responses/too_many_requests.yml
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+security:
+- bearer_auth:
+  - genai:read
+summary: Get Custom Model
+tags:
+- GradientAI Platform
+x-codeSamples:
+- $ref: examples/curl/genai_get_custom_model.yml