feat: Add swagger endpoints for Netlify Identity

Author: NotWoods

swagger.yml

@@ -213,6 +213,154 @@ paths:
           description: Deleted
         default:
           $ref: '#/responses/error'
+  /sites/{site_id}/identity/{identity_instance_id}:
+    get:
+      operationId: identityServiceInstance
+      tags: [identity]
+      responses:
+        '200':
+          description: OK
+          schema:
+            type: array
+            items:
+              $ref: '#/definitions/serviceInstance'
+        default:
+          $ref: '#/responses/error'
+  /sites/{site_id}/identity/{identity_instance_id}/users:
+    get:
+      operationId: listSiteUsers
+      tags: [identity]
+      parameters:
+        - name: site_id
+          type: string
+          in: path
+          required: true
+        - name: identity_instance_id
+          type: string
+          in: path
+          required: true
+        - $ref: '#/parameters/page'
+        - $ref: '#/parameters/perPage'
+        - name: sort
+          schema:
+            type: string
+          in: query
+        - name: filter
+          schema:
+            type: string
+          in: query
+      responses:
+        '200':
+          description: OK
+          schema:
+            type: array
+            items:
+              $ref: '#/definitions/identity_user'
+        default:
+          $ref: '#/responses/error'
+  /sites/{site_id}/identity/{identity_instance_id}/users/{user_id}:
+    get:
+      operationId: getSiteUser
+      tags: [identity]
+      parameters:
+        - name: site_id
+          type: string
+          in: path
+          required: true
+        - name: identity_instance_id
+          type: string
+          in: path
+          required: true
+        - name: user_id
+          type: string
+          in: path
+          required: true
+      responses:
+        '200':
+          description: OK
+          schema:
+            $ref: '#/definitions/identityUser'
+        default:
+          $ref: '#/responses/error'
+    put:
+      operationId: updateSiteUser
+      tags: [identity]
+      consumes:
+        - application/json
+      parameters:
+        - name: site_id
+          type: string
+          in: path
+          required: true
+        - name: identity_instance_id
+          type: string
+          in: path
+          required: true
+        - name: user_id
+          type: string
+          in: path
+          required: true
+        - name: aud
+          in: body
+          schema:
+            type: string
+        - name: role
+          in: body
+          schema:
+            type: string
+        - name: email
+          in: body
+          schema:
+            type: string
+            format: email
+        - name: password
+          in: body
+          schema:
+            type: string
+            format: password
+        - name: confirm
+          in: body
+          schema:
+            type: boolean
+        - name: user_metadata
+          in: body
+          schema:
+            $ref: '#/definitions/identityAppMetadata'
+        - name: app_metadata
+          in: body
+          schema:
+            $ref: '#/definitions/identityUserMetadata'
+      responses:
+        '200':
+          description: OK
+          schema:
+            $ref: '#/definitions/identityUser'
+        default:
+          $ref: '#/responses/error'
+    delete:
+      operationId: deleteSiteUser
+      tags: [identity]
+      parameters:
+        - name: site_id
+          type: string
+          in: path
+          required: true
+        - name: identity_instance_id
+          type: string
+          in: path
+          required: true
+        - name: user_id
+          type: string
+          in: path
+          required: true
+      responses:
+        '200':
+          description: OK
+          schema:
+            type: object
+            properties: []
+        default:
+          $ref: '#/responses/error'
   /sites/{site_id}/submissions:
     get:
       operationId: listSiteSubmissions
@@ -3007,6 +3155,74 @@ definitions:
         properties:
           slides:
             type: string
+  identityAppMetadata:
+    type: object
+    additionalProperties: true
+    properties:
+      provider:
+        type: string
+      roles:
+        type: array
+        items:
+          type: string
+  identityUserMetadata:
+    type: object
+    additionalProperties: true
+    properties:
+      full_name:
+        type: string
+  identityUser:
+    type: object
+    properties:
+      id:
+        type: string
+      aud:
+        type: string
+      role:
+        type: string
+      email:
+        type: string
+        format: email
+      confirmed_at:
+        type: string
+        format: dateTime
+      invited_at:
+        type: string
+        format: dateTime
+      confirmation_sent_at:
+        type: string
+        format: dateTime
+      recovery_sent_at:
+        type: string
+        format: dateTime
+      new_email:
+        type: string
+        format: email
+      email_change_sent_at:
+        type: string
+        format: dateTime
+      last_sign_in_at:
+        type: string
+        format: dateTime
+      app_metadata:
+        $ref: '#/definitions/identityAppMetadata'
+      user_metadata:
+        $ref: '#/definitions/identityUserMetadata'
+      created_at:
+        type: string
+        format: dateTime
+      updated_at:
+        type: string
+        format: dateTime
+    required:
+      - id
+      - aud
+      - role
+      - email
+      - app_metadata
+      - user_metadata
+      - created_at
+      - updated_at
   error:
     type: object
     required:
@@ -3079,6 +3295,9 @@ x-tagGroups:
     tags:
       - form
       - submission
+  - name: Identity
+    tags:
+      - identity
   - name: Split tests
     tags:
       - splitTest