@1claw/openapi-spec 0.15.0 → 0.15.1

package/README.md

@@ -40,7 +40,7 @@ openapi-generator generate \
 import spec from "@1claw/openapi-spec/openapi.json";
 ```
 
-## What's in the spec (v0.14.0)
+## What's in the spec (v0.15.x)
 
 - **Vaults** — CRUD, CMEK enable/disable, key rotation with job tracking
 - **Secrets** — CRUD, versioning, CMEK-encrypted flag
@@ -51,6 +51,7 @@ import spec from "@1claw/openapi-spec/openapi.json";
 - **Audit** — Hash-chained event log
 - **Chains** — Supported blockchain registry
 - **Auth** — JWT, API keys, agent tokens, MFA, device flow, Google OAuth
+- **Org** — List members, invite, update/remove member; `GET /v1/org/agent-keys-vault` (users only, returns __agent-keys vault id or 404)
 
 ## Included files
 

package/openapi.json

@@ -2380,6 +2380,31 @@
         }
       }
     },
+    "/v1/org/agent-keys-vault": {
+      "get": {
+        "tags": [
+          "Organization"
+        ],
+        "summary": "Get the org's __agent-keys vault id",
+        "description": "Returns the vault id for the caller's org agent-keys vault (used for revealing agent identity keys). Users only; 404 if the vault does not exist.",
+        "operationId": "getAgentKeysVault",
+        "responses": {
+          "200": {
+            "description": "Agent-keys vault id",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentKeysVaultResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Agent-keys vault not found"
+          }
+        }
+      }
+    },
     "/v1/org/invite": {
       "post": {
         "tags": [
@@ -5880,6 +5905,15 @@
           }
         }
       },
+      "AgentKeysVaultResponse": {
+        "type": "object",
+        "properties": {
+          "vault_id": {
+            "type": "string",
+            "format": "uuid"
+          }
+        }
+      },
       "UsageSummaryResponse": {
         "type": "object",
         "properties": {

package/openapi.yaml

@@ -1518,6 +1518,22 @@ paths:
                             schema:
                                 $ref: "#/components/schemas/OrgMemberListResponse"
 
+    /v1/org/agent-keys-vault:
+        get:
+            tags: [Organization]
+            summary: Get the org's __agent-keys vault id
+            description: Returns the vault id for the caller's org agent-keys vault (used for revealing agent identity keys). Users only; 404 if the vault does not exist.
+            operationId: getAgentKeysVault
+            responses:
+                "200":
+                    description: Agent-keys vault id
+                    content:
+                        application/json:
+                            schema:
+                                $ref: "#/components/schemas/AgentKeysVaultResponse"
+                "404":
+                    description: Agent-keys vault not found
+
     /v1/org/invite:
         post:
             tags: [Organization]
@@ -3881,6 +3897,13 @@ components:
                 email:
                     type: string
 
+        AgentKeysVaultResponse:
+            type: object
+            properties:
+                vault_id:
+                    type: string
+                    format: uuid
+
         # --- Billing ---
 
         UsageSummaryResponse:

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@1claw/openapi-spec",
-    "version": "0.15.0",
+    "version": "0.15.1",
     "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API — generate clients in any language",
     "license": "MIT",
     "repository": {