@1claw/openapi-spec 0.61.45 → 0.61.46

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "1Claw API",
-    "version": "0.61.45",
+    "version": "0.61.46",
     "description": "Secure secret management for AI agents. Provides vaults, secrets,\npolicy-based access control, agent identity, Intents API,\nsharing, billing, and audit logging. Automations (workflow_spec,\nwebhook tokens, event triggers, Assist), cloud runtimes with\ninteractive shell sessions, agent memory, and discovery.\n\n## Domains\n\n`api.1claw.co` is canonical: it is the OIDC issuer, the `aud` the API\nmints, and the first entry in `servers` — a generated client takes its\nbase URL from there, and the previous ordering pointed every SDK at the\ndomain the issuer had already left. `api.1claw.xyz` still answers and is\nstill accepted on token validation, because tokens minted before the\nmove carry it; it is never minted now.\n\nOne deliberate exception: the Shroud attestation identity token is\nrequested from GCP with `audience: https://api.1claw.xyz`, so\n`/v1/shroud/attestation` reports that as its `expected_audience`. That\nis accurate rather than stale — the audience is a verification contract\nwith anyone already checking the token, and moving it is a breaking\nchange for them, not a rename.\n\nAll endpoints require JWT Bearer authentication unless marked with\n`security: []`.\n",
     "contact": {
       "email": "ops@1claw.co"
@@ -28291,6 +28291,55 @@
         }
       }
     },
+    "/v1/connectors/suggest": {
+      "get": {
+        "tags": [
+          "Connectors"
+        ],
+        "summary": "Is there a connector for this credential?",
+        "description": "Asked before a secret is written, so the caller can offer to connect the service properly instead of filing a key that cannot do the job. A user stored an X bearer token, a consumer key and a consumer secret and asked their agent to post daily; none of the three can post, because X needs a user-context OAuth grant. Nothing said so until the agent failed.\n\nMatches on both a provider name and a credential word, so `api-keys/x-bearer-token` suggests the X connector and `notes/slack-migration-plan` suggests nothing — a hint that fires on every path is one people learn to scroll past.\n",
+        "operationId": "suggest_connector",
+        "parameters": [
+          {
+            "name": "path",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The secret path about to be written."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The matching connector, or null.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "preset"
+                  ],
+                  "properties": {
+                    "preset": {
+                      "nullable": true,
+                      "allOf": [
+                        {
+                          "$ref": "#/components/schemas/ConnectorPreset"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthenticated"
+          }
+        }
+      }
+    },
     "/v1/billing/promo/preview": {
       "get": {
         "tags": [

package/openapi.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 
 info:
     title: 1Claw API
-    version: "0.61.45"
+    version: "0.61.46"
     description: |
         Secure secret management for AI agents. Provides vaults, secrets,
         policy-based access control, agent identity, Intents API,
@@ -18065,6 +18065,45 @@ paths:
                 answered GET would look like a working unsubscribe to a
                 person and a broken one to the providers scoring the domain.
             operationId: marketing_unsubscribe_post
+    /v1/connectors/suggest:
+        get:
+            tags: [Connectors]
+            summary: "Is there a connector for this credential?"
+            description: >
+                Asked before a secret is written, so the caller can offer to
+                connect the service properly instead of filing a key that
+                cannot do the job. A user stored an X bearer token, a consumer
+                key and a consumer secret and asked their agent to post daily;
+                none of the three can post, because X needs a user-context
+                OAuth grant. Nothing said so until the agent failed.
+
+
+                Matches on both a provider name and a credential word, so
+                `api-keys/x-bearer-token` suggests the X connector and
+                `notes/slack-migration-plan` suggests nothing — a hint that
+                fires on every path is one people learn to scroll past.
+            operationId: suggest_connector
+            parameters:
+                - name: path
+                  in: query
+                  required: true
+                  schema: { type: string }
+                  description: The secret path about to be written.
+            responses:
+                '200':
+                    description: The matching connector, or null.
+                    content:
+                        application/json:
+                            schema:
+                                type: object
+                                required: [preset]
+                                properties:
+                                    preset:
+                                        nullable: true
+                                        allOf:
+                                            - $ref: '#/components/schemas/ConnectorPreset'
+                '401':
+                    description: Unauthenticated
     /v1/billing/promo/preview:
         get:
             tags: [Billing]

package/package.json

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