Deployed 8051229 to dev with MkDocs 1.6.1 and mike 2.1.4

Author: github-actions[bot]

dev/api/openapi3.yaml

@@ -283,26 +283,28 @@ paths:
             tags:
                 - api-keys-v2
             summary: Create a new hash-based API key
-            description: Creates a new OpenAI-compatible API key (sk-oai-* format). If expiresIn is not provided, defaults to API_KEY_MAX_EXPIRATION_DAYS (default 90 days). The plaintext key is shown ONLY ONCE at creation time and cannot be retrieved again.
+            description: Creates a new OpenAI-compatible API key (sk-oai-* format). Name is required for regular keys but optional for ephemeral keys. If expiresIn is not provided, defaults to API_KEY_MAX_EXPIRATION_DAYS (default 90 days) for regular keys, or 1 hour for ephemeral keys. The plaintext key is shown ONLY ONCE at creation time and cannot be retrieved again.
             operationId: api-keys-v2#create
             requestBody:
                 required: true
                 content:
                     application/json:
                         schema:
                             type: object
-                            required:
-                                - name
                             properties:
                                 name:
                                     type: string
-                                    description: Human-readable name for the API key
+                                    description: Human-readable name for the API key. Required for regular keys, optional for ephemeral keys.
                                 description:
                                     type: string
                                     description: Optional description
                                 expiresIn:
                                     type: string
-                                    description: Expiration duration (e.g., "30d", "90d", "1h"). Defaults to API_KEY_MAX_EXPIRATION_DAYS if not provided.
+                                    description: Expiration duration (e.g., "30d", "90d", "1h"). Defaults to API_KEY_MAX_EXPIRATION_DAYS for regular keys, 1 hour for ephemeral keys.
+                                ephemeral:
+                                    type: boolean
+                                    description: Create a short-lived programmatic key. Defaults to false. Ephemeral keys have 1hr default and maximum expiration (enforced), and optional name.
+                                    default: false
                         examples:
                             default_expiration:
                                 summary: API key with default expiration (API_KEY_MAX_EXPIRATION_DAYS)
@@ -315,13 +317,25 @@ paths:
                                     name: my-short-lived-key
                                     description: 30-day test key
                                     expiresIn: 30d
+                            ephemeral_key:
+                                summary: Ephemeral key for programmatic use (1hr expiration)
+                                value:
+                                    ephemeral: true
             responses:
                 "201":
                     description: Created response.
                     content:
                         application/json:
                             schema:
                                 type: object
+                                required:
+                                    - key
+                                    - keyPrefix
+                                    - id
+                                    - name
+                                    - createdAt
+                                    - expiresAt
+                                    - ephemeral
                                 properties:
                                     key:
                                         type: string
@@ -343,6 +357,9 @@ paths:
                                         type: string
                                         format: date-time
                                         description: Expiration timestamp (RFC3339)
+                                    ephemeral:
+                                        type: boolean
+                                        description: Whether this is a short-lived programmatic key
                 "400":
                     description: Bad Request response.
                 "401":
@@ -352,7 +369,7 @@ paths:
             tags:
                 - api-keys-v2
             summary: Search and filter API keys
-            description: Search API keys with flexible filtering, sorting, and pagination. Supports filtering by username (admin-only), status, sorting by multiple fields, and pagination.
+            description: Search API keys with flexible filtering, sorting, and pagination. Supports filtering by username (admin-only), status, sorting by multiple fields, and pagination. Ephemeral keys are excluded by default.
             operationId: api-keys-v2#search
             requestBody:
                 required: false
@@ -373,6 +390,10 @@ paths:
                                                 type: string
                                                 enum: [active, revoked, expired]
                                             description: Filter by status (active, revoked, expired). Defaults to active only.
+                                        includeEphemeral:
+                                            type: boolean
+                                            description: Include ephemeral keys in results. Defaults to false.
+                                            default: false
                                 sort:
                                     type: object
                                     properties:
@@ -398,7 +419,7 @@ paths:
                                             default: 0
                         examples:
                             default_search:
-                                summary: Default search (active keys, newest first)
+                                summary: Default search (active keys, newest first, excludes ephemeral)
                                 value:
                                     filters:
                                         status: ["active"]
@@ -420,6 +441,12 @@ paths:
                                     pagination:
                                         limit: 20
                                         offset: 0
+                            include_ephemeral:
+                                summary: Include ephemeral keys in search
+                                value:
+                                    filters:
+                                        status: ["active"]
+                                        includeEphemeral: true
             responses:
                 "200":
                     description: OK response.
@@ -434,11 +461,13 @@ paths:
                                       name: my-production-key
                                       creationDate: "2024-01-15T10:30:00Z"
                                       status: active
+                                      ephemeral: false
                                     - id: key_def456
                                       name: my-test-key
                                       creationDate: "2024-01-14T09:15:00Z"
                                       expirationDate: "2024-04-14T09:15:00Z"
                                       status: active
+                                      ephemeral: false
                                 has_more: true
                 "400":
                     description: Bad Request. Invalid search parameters.
@@ -559,6 +588,7 @@ paths:
                                 name: my-production-key
                                 creationDate: "2024-01-15T10:30:00Z"
                                 status: revoked
+                                ephemeral: false
                 "404":
                     description: Not Found. API key not found.
                 "401":
@@ -807,11 +837,15 @@ components:
                     type: string
                     format: date-time
                     description: When the API key was last used for validation
+                ephemeral:
+                    type: boolean
+                    description: Whether this is a short-lived programmatic token
             required:
                 - id
                 - name
                 - creationDate
                 - status
+                - ephemeral
 
         # API Key List Response (paginated)
         ApiKeyListResponse:

dev/sitemap.xml

@@ -2,130 +2,130 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/architecture/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/quickstart/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/advanced-administration/limitador-persistence/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/advanced-administration/observability/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/advanced-administration/subscription-cardinality/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/group-membership-known-issues/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/maas-controller-overview/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/maas-model-kinds/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/maas-models/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/model-access-behavior/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/model-listing-flow/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/model-setup/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/quota-and-access-configuration/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/subscription-known-issues/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/subscription-overview/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/tls-configuration/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/configuration-and-management/token-management/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/install/maas-setup/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/install/model-setup/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/install/platform-setup/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/install/prerequisites/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/install/troubleshooting/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/install/validation/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/migration/tier-to-subscription/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/reference/api-reference/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/reference/maas-api-overview/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/reference/crds/maas-auth-policy/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/reference/crds/maas-model-ref/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/reference/crds/maas-subscription/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/release-notes/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
     <url>
          <loc>https://opendatahub-io.github.io/models-as-a-service/dev/user-guide/self-service-model-access/</loc>
-         <lastmod>2026-03-19</lastmod>
+         <lastmod>2026-03-20</lastmod>
     </url>
 </urlset>