docs: update API reference spec (#271)

Co-authored-by: Lukáš Huvar <lukas@huvar.cz>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: 3 people

openapi-public.yml

@@ -353,6 +353,12 @@ paths:
       - ApiKeyAuth: []
       parameters:
       - $ref: '#/components/parameters/sandboxID'
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/SandboxPauseRequest'
       responses:
         '204':
           description: The sandbox was paused successfully and can be resumed
@@ -632,6 +638,46 @@ paths:
     servers:
     - *id001
   /v2/templates:
+    get:
+      description: List all templates
+      tags:
+      - Templates
+      security:
+      - ApiKeyAuth: []
+      - AccessTokenAuth: []
+      parameters:
+      - in: query
+        required: false
+        name: teamID
+        schema:
+          type: string
+          description: Identifier of the team
+      - $ref: '#/components/parameters/paginationNextToken'
+      - $ref: '#/components/parameters/paginationLimit'
+      responses:
+        '200':
+          description: Successfully returned all templates
+          headers:
+            X-Next-Token:
+              description: Cursor to fetch the next page of results, if more exist
+              schema:
+                type: string
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/Template'
+        '400':
+          $ref: '#/components/responses/400'
+        '401':
+          $ref: '#/components/responses/401'
+        '403':
+          $ref: '#/components/responses/403'
+        '500':
+          $ref: '#/components/responses/500'
+      operationId: listTemplatesV2
+      summary: List templates (v2)
     post:
       description: Create a new template
       deprecated: true
@@ -700,6 +746,7 @@ paths:
   /templates:
     get:
       description: List all templates
+      deprecated: true
       tags:
       - Templates
       security:
@@ -4091,6 +4138,16 @@ components:
           type: boolean
           default: false
           description: Automatically pauses the sandbox after the timeout
+        autoPauseMemory:
+          type: boolean
+          default: true
+          description: Controls the snapshot kind taken when the sandbox auto-pauses
+            on timeout (only relevant when autoPause is true). When false, the auto-pause
+            drops the in-memory state and persists only the filesystem (a filesystem-only
+            snapshot); resuming it cold-boots (reboots) the sandbox from disk. Such
+            a snapshot cannot be auto-resumed by traffic and must be resumed explicitly,
+            so it cannot be combined with autoResume. Defaults to true (full memory
+            snapshot).
         autoResume:
           $ref: '#/components/schemas/SandboxAutoResumeConfig'
         secure:
@@ -4164,6 +4221,18 @@ components:
           description: Optional name for the snapshot template. If a snapshot template
             with this name already exists, a new build will be assigned to the existing
             template instead of creating a new one.
+    SandboxPauseRequest:
+      type: object
+      properties:
+        memory:
+          type: boolean
+          default: true
+          description: Whether to capture a full memory snapshot. When false, only
+            the filesystem is persisted and resuming the sandbox cold-boots (reboots)
+            it from disk, losing in-memory state, running processes, and open connections.
+            Resume it with an explicit request (connect or resume); auto-resume, which
+            can be triggered by arbitrary traffic, refuses such a sandbox. Defaults
+            to true.
     TeamMetric:
       description: Team metric with timestamp
       required: