@1claw/openapi-spec 0.59.0 → 0.59.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +11 -1
  2. package/openapi.json +1106 -12
  3. package/openapi.yaml +801 -77
  4. package/package.json +1 -1
package/openapi.json CHANGED
@@ -6218,6 +6218,60 @@
6218
6218
  }
6219
6219
  }
6220
6220
  },
6221
+ "/v1/org/onboarding/status": {
6222
+ "get": {
6223
+ "tags": [
6224
+ "Organization"
6225
+ ],
6226
+ "summary": "Onboarding funnel status",
6227
+ "description": "Returns welcome-bundle and MCP connection progress for the connect wizard.",
6228
+ "operationId": "getOnboardingStatus",
6229
+ "responses": {
6230
+ "200": {
6231
+ "description": "Onboarding status",
6232
+ "content": {
6233
+ "application/json": {
6234
+ "schema": {
6235
+ "$ref": "#/components/schemas/OnboardingStatus"
6236
+ }
6237
+ }
6238
+ }
6239
+ }
6240
+ }
6241
+ }
6242
+ },
6243
+ "/v1/onboarding/provision": {
6244
+ "post": {
6245
+ "tags": [
6246
+ "Organization"
6247
+ ],
6248
+ "summary": "Provision MCP onboarding bundle",
6249
+ "description": "Creates welcome vault + sample secret, MCP agent, and default ** policy. Returns one-time API key and stdio MCP config.",
6250
+ "operationId": "provisionOnboarding",
6251
+ "requestBody": {
6252
+ "required": false,
6253
+ "content": {
6254
+ "application/json": {
6255
+ "schema": {
6256
+ "$ref": "#/components/schemas/OnboardingProvisionRequest"
6257
+ }
6258
+ }
6259
+ }
6260
+ },
6261
+ "responses": {
6262
+ "200": {
6263
+ "description": "Provisioned resources",
6264
+ "content": {
6265
+ "application/json": {
6266
+ "schema": {
6267
+ "$ref": "#/components/schemas/OnboardingProvisionResponse"
6268
+ }
6269
+ }
6270
+ }
6271
+ }
6272
+ }
6273
+ }
6274
+ },
6221
6275
  "/v1/org/status": {
6222
6276
  "get": {
6223
6277
  "tags": [
@@ -9320,6 +9374,46 @@
9320
9374
  }
9321
9375
  }
9322
9376
  },
9377
+ "/v1/shroud/inspect-content": {
9378
+ "post": {
9379
+ "tags": [
9380
+ "Shroud"
9381
+ ],
9382
+ "summary": "Inspect text for security threats",
9383
+ "description": "Standalone content inspection (MCP `inspect_content` parity). Scans for command\ninjection, encoding tricks, social engineering, PII, and suspicious URLs.\nFail-closed — returns `safe: false` when high/critical threats match.\nAccepts plt_ platform keys, agent JWTs, and user JWTs.\n",
9384
+ "operationId": "inspectContent",
9385
+ "security": [
9386
+ {
9387
+ "BearerAuth": []
9388
+ }
9389
+ ],
9390
+ "requestBody": {
9391
+ "required": true,
9392
+ "content": {
9393
+ "application/json": {
9394
+ "schema": {
9395
+ "$ref": "#/components/schemas/InspectContentRequest"
9396
+ }
9397
+ }
9398
+ }
9399
+ },
9400
+ "responses": {
9401
+ "200": {
9402
+ "description": "Inspection report",
9403
+ "content": {
9404
+ "application/json": {
9405
+ "schema": {
9406
+ "$ref": "#/components/schemas/InspectContentResponse"
9407
+ }
9408
+ }
9409
+ }
9410
+ },
9411
+ "400": {
9412
+ "$ref": "#/components/responses/BadRequest"
9413
+ }
9414
+ }
9415
+ }
9416
+ },
9323
9417
  "/v1/shroud/activity": {
9324
9418
  "get": {
9325
9419
  "tags": [
@@ -9844,6 +9938,47 @@
9844
9938
  }
9845
9939
  }
9846
9940
  },
9941
+ "/v1/platform/apps/{appId}/webhooks": {
9942
+ "get": {
9943
+ "tags": [
9944
+ "Platform"
9945
+ ],
9946
+ "summary": "Platform webhook delivery catalog",
9947
+ "description": "Returns whether `webhook_url` is configured and the event types delivered to\nthe platform app webhook (payload includes `connection_id` when applicable).\nOrg-scoped webhook subscriptions (`GET /v1/webhooks`) are separate.\n",
9948
+ "operationId": "getPlatformWebhooks",
9949
+ "security": [
9950
+ {
9951
+ "BearerAuth": []
9952
+ }
9953
+ ],
9954
+ "parameters": [
9955
+ {
9956
+ "name": "appId",
9957
+ "in": "path",
9958
+ "required": true,
9959
+ "schema": {
9960
+ "type": "string",
9961
+ "format": "uuid"
9962
+ }
9963
+ }
9964
+ ],
9965
+ "responses": {
9966
+ "200": {
9967
+ "description": "Webhook configuration summary",
9968
+ "content": {
9969
+ "application/json": {
9970
+ "schema": {
9971
+ "$ref": "#/components/schemas/PlatformWebhookInfoResponse"
9972
+ }
9973
+ }
9974
+ }
9975
+ },
9976
+ "404": {
9977
+ "$ref": "#/components/responses/NotFound"
9978
+ }
9979
+ }
9980
+ }
9981
+ },
9847
9982
  "/v1/platform/apps/{appId}/rotate-webhook-secret": {
9848
9983
  "post": {
9849
9984
  "tags": [
@@ -11618,6 +11753,58 @@
11618
11753
  "$ref": "#/components/responses/NotFound"
11619
11754
  }
11620
11755
  }
11756
+ },
11757
+ "post": {
11758
+ "tags": [
11759
+ "Platform"
11760
+ ],
11761
+ "summary": "Create a pending consensus approval for a connection agent",
11762
+ "description": "Platform apps submit over-cap or consensus-gated actions on behalf of a\nconnected user's agent. When `policy_id` is omitted, the server resolves the\nmatching agent `consensus_trigger` policy from `action_payload` (chain, to, value).\nReturns **202** with `pending_approval_id` and `payload_hash` for decide/execute.\nRequires plt_ auth; agent must be provisioned on the connection.\n",
11763
+ "operationId": "createConnectionPendingApproval",
11764
+ "security": [
11765
+ {
11766
+ "BearerAuth": []
11767
+ }
11768
+ ],
11769
+ "parameters": [
11770
+ {
11771
+ "in": "path",
11772
+ "name": "connectionId",
11773
+ "required": true,
11774
+ "schema": {
11775
+ "type": "string",
11776
+ "format": "uuid"
11777
+ }
11778
+ }
11779
+ ],
11780
+ "requestBody": {
11781
+ "required": true,
11782
+ "content": {
11783
+ "application/json": {
11784
+ "schema": {
11785
+ "$ref": "#/components/schemas/ConnectionSubmitPendingApprovalRequest"
11786
+ }
11787
+ }
11788
+ }
11789
+ },
11790
+ "responses": {
11791
+ "202": {
11792
+ "description": "Pending approval created",
11793
+ "content": {
11794
+ "application/json": {
11795
+ "schema": {
11796
+ "$ref": "#/components/schemas/SubmitPendingApprovalResponse"
11797
+ }
11798
+ }
11799
+ }
11800
+ },
11801
+ "400": {
11802
+ "$ref": "#/components/responses/BadRequest"
11803
+ },
11804
+ "404": {
11805
+ "$ref": "#/components/responses/NotFound"
11806
+ }
11807
+ }
11621
11808
  }
11622
11809
  },
11623
11810
  "/v1/platform/connections/{connectionId}/pending-approvals/{approvalId}": {
@@ -11819,16 +12006,630 @@
11819
12006
  "description": "Already decided"
11820
12007
  }
11821
12008
  }
11822
- }
11823
- },
11824
- "/v1/platform/connections/{connectionId}/signing-keys/{chain}": {
12009
+ }
12010
+ },
12011
+ "/v1/platform/connections/{connectionId}/signing-keys": {
12012
+ "get": {
12013
+ "tags": [
12014
+ "Platform"
12015
+ ],
12016
+ "summary": "List signing keys for a connection agent",
12017
+ "description": "Returns public signing-key metadata (chain, address, public_key, curve) for\nagent(s) provisioned on the connection. Never includes private keys.\nWhen multiple agents exist, pass `agent_id` query param. plt_ auth only.\n",
12018
+ "operationId": "listConnectionSigningKeys",
12019
+ "security": [
12020
+ {
12021
+ "BearerAuth": []
12022
+ }
12023
+ ],
12024
+ "parameters": [
12025
+ {
12026
+ "in": "path",
12027
+ "name": "connectionId",
12028
+ "required": true,
12029
+ "schema": {
12030
+ "type": "string",
12031
+ "format": "uuid"
12032
+ }
12033
+ },
12034
+ {
12035
+ "in": "query",
12036
+ "name": "agent_id",
12037
+ "required": false,
12038
+ "schema": {
12039
+ "type": "string",
12040
+ "format": "uuid"
12041
+ }
12042
+ }
12043
+ ],
12044
+ "responses": {
12045
+ "200": {
12046
+ "description": "Signing keys for the connection agent",
12047
+ "content": {
12048
+ "application/json": {
12049
+ "schema": {
12050
+ "$ref": "#/components/schemas/ConnectionSigningKeyListResponse"
12051
+ }
12052
+ }
12053
+ }
12054
+ },
12055
+ "400": {
12056
+ "description": "Multiple agents — agent_id required"
12057
+ },
12058
+ "404": {
12059
+ "$ref": "#/components/responses/NotFound"
12060
+ }
12061
+ }
12062
+ }
12063
+ },
12064
+ "/v1/platform/connections/{connectionId}/signing-keys/{chain}": {
12065
+ "get": {
12066
+ "tags": [
12067
+ "Platform"
12068
+ ],
12069
+ "summary": "Get a signing key for a connection agent by chain",
12070
+ "description": "Returns public signing-key metadata for one chain on a connection agent.\nNetwork names (e.g. `base`, `sepolia`) resolve to canonical signing keys\n(e.g. `ethereum`). Never includes private keys. plt_ auth only.\n",
12071
+ "operationId": "getConnectionSigningKey",
12072
+ "security": [
12073
+ {
12074
+ "BearerAuth": []
12075
+ }
12076
+ ],
12077
+ "parameters": [
12078
+ {
12079
+ "in": "path",
12080
+ "name": "connectionId",
12081
+ "required": true,
12082
+ "schema": {
12083
+ "type": "string",
12084
+ "format": "uuid"
12085
+ }
12086
+ },
12087
+ {
12088
+ "in": "path",
12089
+ "name": "chain",
12090
+ "required": true,
12091
+ "schema": {
12092
+ "type": "string"
12093
+ }
12094
+ },
12095
+ {
12096
+ "in": "query",
12097
+ "name": "agent_id",
12098
+ "required": false,
12099
+ "schema": {
12100
+ "type": "string",
12101
+ "format": "uuid"
12102
+ }
12103
+ }
12104
+ ],
12105
+ "responses": {
12106
+ "200": {
12107
+ "description": "Signing key metadata",
12108
+ "content": {
12109
+ "application/json": {
12110
+ "schema": {
12111
+ "$ref": "#/components/schemas/ConnectionSigningKeyDetailResponse"
12112
+ }
12113
+ }
12114
+ }
12115
+ },
12116
+ "400": {
12117
+ "description": "Multiple agents — agent_id required"
12118
+ },
12119
+ "404": {
12120
+ "$ref": "#/components/responses/NotFound"
12121
+ }
12122
+ }
12123
+ },
12124
+ "delete": {
12125
+ "tags": [
12126
+ "Platform"
12127
+ ],
12128
+ "summary": "Deactivate a signing key for a connection agent",
12129
+ "description": "Deactivates the signing key for an agent provisioned on the connection.\nWhen multiple agents exist, pass `agent_id` query param. plt_ auth only.\n",
12130
+ "operationId": "deactivateConnectionSigningKey",
12131
+ "security": [
12132
+ {
12133
+ "BearerAuth": []
12134
+ }
12135
+ ],
12136
+ "parameters": [
12137
+ {
12138
+ "in": "path",
12139
+ "name": "connectionId",
12140
+ "required": true,
12141
+ "schema": {
12142
+ "type": "string",
12143
+ "format": "uuid"
12144
+ }
12145
+ },
12146
+ {
12147
+ "in": "path",
12148
+ "name": "chain",
12149
+ "required": true,
12150
+ "schema": {
12151
+ "type": "string"
12152
+ }
12153
+ },
12154
+ {
12155
+ "in": "query",
12156
+ "name": "agent_id",
12157
+ "required": false,
12158
+ "schema": {
12159
+ "type": "string",
12160
+ "format": "uuid"
12161
+ }
12162
+ }
12163
+ ],
12164
+ "responses": {
12165
+ "204": {
12166
+ "description": "Key deactivated"
12167
+ },
12168
+ "400": {
12169
+ "description": "Multiple agents — agent_id required"
12170
+ },
12171
+ "404": {
12172
+ "$ref": "#/components/responses/NotFound"
12173
+ }
12174
+ }
12175
+ }
12176
+ },
12177
+ "/v1/platform/connections/{connectionId}/agents/{agentId}": {
12178
+ "patch": {
12179
+ "tags": [
12180
+ "Platform"
12181
+ ],
12182
+ "summary": "Update limited agent settings for a connection",
12183
+ "description": "Platform-scoped agent update for connected end-users. Allows enabling Intents API,\nExecution Intents, and updating the default system prompt without human dashboard access.\nAgent must be provisioned on the connection. plt_ auth only.\n",
12184
+ "operationId": "patchConnectionAgent",
12185
+ "security": [
12186
+ {
12187
+ "BearerAuth": []
12188
+ }
12189
+ ],
12190
+ "parameters": [
12191
+ {
12192
+ "in": "path",
12193
+ "name": "connectionId",
12194
+ "required": true,
12195
+ "schema": {
12196
+ "type": "string",
12197
+ "format": "uuid"
12198
+ }
12199
+ },
12200
+ {
12201
+ "in": "path",
12202
+ "name": "agentId",
12203
+ "required": true,
12204
+ "schema": {
12205
+ "type": "string",
12206
+ "format": "uuid"
12207
+ }
12208
+ }
12209
+ ],
12210
+ "requestBody": {
12211
+ "required": true,
12212
+ "content": {
12213
+ "application/json": {
12214
+ "schema": {
12215
+ "$ref": "#/components/schemas/PatchConnectionAgentRequest"
12216
+ }
12217
+ }
12218
+ }
12219
+ },
12220
+ "responses": {
12221
+ "200": {
12222
+ "description": "Updated agent settings",
12223
+ "content": {
12224
+ "application/json": {
12225
+ "schema": {
12226
+ "$ref": "#/components/schemas/PatchConnectionAgentResponse"
12227
+ }
12228
+ }
12229
+ }
12230
+ },
12231
+ "400": {
12232
+ "$ref": "#/components/responses/BadRequest"
12233
+ },
12234
+ "403": {
12235
+ "$ref": "#/components/responses/Forbidden"
12236
+ },
12237
+ "404": {
12238
+ "$ref": "#/components/responses/NotFound"
12239
+ }
12240
+ }
12241
+ }
12242
+ },
12243
+ "/v1/platform/connections/{connectionId}/portfolio": {
12244
+ "get": {
12245
+ "tags": [
12246
+ "Platform"
12247
+ ],
12248
+ "summary": "Portfolio for connection agents",
12249
+ "description": "Aggregates signing-key and smart-account balances for agents provisioned on\nthe connection. plt_ auth only.\n",
12250
+ "operationId": "getConnectionPortfolio",
12251
+ "security": [
12252
+ {
12253
+ "BearerAuth": []
12254
+ }
12255
+ ],
12256
+ "parameters": [
12257
+ {
12258
+ "in": "path",
12259
+ "name": "connectionId",
12260
+ "required": true,
12261
+ "schema": {
12262
+ "type": "string",
12263
+ "format": "uuid"
12264
+ }
12265
+ },
12266
+ {
12267
+ "in": "query",
12268
+ "name": "chains",
12269
+ "required": false,
12270
+ "schema": {
12271
+ "type": "string",
12272
+ "description": "Comma-separated chain filter (e.g. `ethereum,base`)"
12273
+ }
12274
+ },
12275
+ {
12276
+ "in": "query",
12277
+ "name": "include_tokens",
12278
+ "required": false,
12279
+ "schema": {
12280
+ "type": "boolean"
12281
+ }
12282
+ }
12283
+ ],
12284
+ "responses": {
12285
+ "200": {
12286
+ "description": "Connection-scoped portfolio",
12287
+ "content": {
12288
+ "application/json": {
12289
+ "schema": {
12290
+ "$ref": "#/components/schemas/PortfolioResponse"
12291
+ }
12292
+ }
12293
+ }
12294
+ },
12295
+ "404": {
12296
+ "$ref": "#/components/responses/NotFound"
12297
+ }
12298
+ }
12299
+ }
12300
+ },
12301
+ "/v1/platform/connections/{connectionId}/balances": {
12302
+ "get": {
12303
+ "tags": [
12304
+ "Platform"
12305
+ ],
12306
+ "summary": "Balances alias for connection portfolio",
12307
+ "description": "Alias of `GET .../portfolio`. plt_ auth only.",
12308
+ "operationId": "getConnectionBalances",
12309
+ "security": [
12310
+ {
12311
+ "BearerAuth": []
12312
+ }
12313
+ ],
12314
+ "parameters": [
12315
+ {
12316
+ "in": "path",
12317
+ "name": "connectionId",
12318
+ "required": true,
12319
+ "schema": {
12320
+ "type": "string",
12321
+ "format": "uuid"
12322
+ }
12323
+ },
12324
+ {
12325
+ "in": "query",
12326
+ "name": "chains",
12327
+ "required": false,
12328
+ "schema": {
12329
+ "type": "string"
12330
+ }
12331
+ }
12332
+ ],
12333
+ "responses": {
12334
+ "200": {
12335
+ "description": "Connection-scoped portfolio",
12336
+ "content": {
12337
+ "application/json": {
12338
+ "schema": {
12339
+ "$ref": "#/components/schemas/PortfolioResponse"
12340
+ }
12341
+ }
12342
+ }
12343
+ }
12344
+ }
12345
+ }
12346
+ },
12347
+ "/v1/platform/connections/{connectionId}/automations": {
12348
+ "get": {
12349
+ "tags": [
12350
+ "Platform"
12351
+ ],
12352
+ "summary": "List automations for connection agents",
12353
+ "operationId": "listConnectionAutomations",
12354
+ "security": [
12355
+ {
12356
+ "BearerAuth": []
12357
+ }
12358
+ ],
12359
+ "parameters": [
12360
+ {
12361
+ "in": "path",
12362
+ "name": "connectionId",
12363
+ "required": true,
12364
+ "schema": {
12365
+ "type": "string",
12366
+ "format": "uuid"
12367
+ }
12368
+ }
12369
+ ],
12370
+ "responses": {
12371
+ "200": {
12372
+ "description": "Automations scoped to connection agents",
12373
+ "content": {
12374
+ "application/json": {
12375
+ "schema": {
12376
+ "$ref": "#/components/schemas/AutomationListResponse"
12377
+ }
12378
+ }
12379
+ }
12380
+ }
12381
+ }
12382
+ },
12383
+ "post": {
12384
+ "tags": [
12385
+ "Platform"
12386
+ ],
12387
+ "summary": "Create automation for a connection agent",
12388
+ "operationId": "createConnectionAutomation",
12389
+ "security": [
12390
+ {
12391
+ "BearerAuth": []
12392
+ }
12393
+ ],
12394
+ "parameters": [
12395
+ {
12396
+ "in": "path",
12397
+ "name": "connectionId",
12398
+ "required": true,
12399
+ "schema": {
12400
+ "type": "string",
12401
+ "format": "uuid"
12402
+ }
12403
+ }
12404
+ ],
12405
+ "requestBody": {
12406
+ "required": true,
12407
+ "content": {
12408
+ "application/json": {
12409
+ "schema": {
12410
+ "$ref": "#/components/schemas/CreateAutomationRequest"
12411
+ }
12412
+ }
12413
+ }
12414
+ },
12415
+ "responses": {
12416
+ "201": {
12417
+ "description": "Automation created",
12418
+ "content": {
12419
+ "application/json": {
12420
+ "schema": {
12421
+ "$ref": "#/components/schemas/AutomationCreatedResponse"
12422
+ }
12423
+ }
12424
+ }
12425
+ },
12426
+ "403": {
12427
+ "$ref": "#/components/responses/Forbidden"
12428
+ }
12429
+ }
12430
+ }
12431
+ },
12432
+ "/v1/platform/connections/{connectionId}/automations/{automationId}/runs/{runId}/cancel": {
12433
+ "post": {
12434
+ "tags": [
12435
+ "Platform"
12436
+ ],
12437
+ "summary": "Cancel an automation run (connection-scoped)",
12438
+ "operationId": "cancelConnectionAutomationRun",
12439
+ "security": [
12440
+ {
12441
+ "BearerAuth": []
12442
+ }
12443
+ ],
12444
+ "parameters": [
12445
+ {
12446
+ "in": "path",
12447
+ "name": "connectionId",
12448
+ "required": true,
12449
+ "schema": {
12450
+ "type": "string",
12451
+ "format": "uuid"
12452
+ }
12453
+ },
12454
+ {
12455
+ "in": "path",
12456
+ "name": "automationId",
12457
+ "required": true,
12458
+ "schema": {
12459
+ "type": "string",
12460
+ "format": "uuid"
12461
+ }
12462
+ },
12463
+ {
12464
+ "in": "path",
12465
+ "name": "runId",
12466
+ "required": true,
12467
+ "schema": {
12468
+ "type": "string",
12469
+ "format": "uuid"
12470
+ }
12471
+ }
12472
+ ],
12473
+ "responses": {
12474
+ "200": {
12475
+ "description": "Run cancelled",
12476
+ "content": {
12477
+ "application/json": {
12478
+ "schema": {
12479
+ "$ref": "#/components/schemas/AutomationRunResponse"
12480
+ }
12481
+ }
12482
+ }
12483
+ },
12484
+ "404": {
12485
+ "$ref": "#/components/responses/NotFound"
12486
+ }
12487
+ }
12488
+ }
12489
+ },
12490
+ "/v1/platform/connections/{connectionId}/memory/{namespace}/{key}": {
12491
+ "get": {
12492
+ "tags": [
12493
+ "Platform"
12494
+ ],
12495
+ "summary": "Get agent memory entry (connection-scoped)",
12496
+ "operationId": "getConnectionMemory",
12497
+ "security": [
12498
+ {
12499
+ "BearerAuth": []
12500
+ }
12501
+ ],
12502
+ "parameters": [
12503
+ {
12504
+ "in": "path",
12505
+ "name": "connectionId",
12506
+ "required": true,
12507
+ "schema": {
12508
+ "type": "string",
12509
+ "format": "uuid"
12510
+ }
12511
+ },
12512
+ {
12513
+ "in": "path",
12514
+ "name": "namespace",
12515
+ "required": true,
12516
+ "schema": {
12517
+ "type": "string"
12518
+ }
12519
+ },
12520
+ {
12521
+ "in": "path",
12522
+ "name": "key",
12523
+ "required": true,
12524
+ "schema": {
12525
+ "type": "string"
12526
+ }
12527
+ },
12528
+ {
12529
+ "in": "query",
12530
+ "name": "agent_id",
12531
+ "required": false,
12532
+ "schema": {
12533
+ "type": "string",
12534
+ "format": "uuid"
12535
+ }
12536
+ }
12537
+ ],
12538
+ "responses": {
12539
+ "200": {
12540
+ "description": "Memory entry",
12541
+ "content": {
12542
+ "application/json": {
12543
+ "schema": {
12544
+ "$ref": "#/components/schemas/MemoryEntry"
12545
+ }
12546
+ }
12547
+ }
12548
+ },
12549
+ "403": {
12550
+ "$ref": "#/components/responses/Forbidden"
12551
+ },
12552
+ "404": {
12553
+ "$ref": "#/components/responses/NotFound"
12554
+ }
12555
+ }
12556
+ },
12557
+ "put": {
12558
+ "tags": [
12559
+ "Platform"
12560
+ ],
12561
+ "summary": "Upsert agent memory entry (connection-scoped)",
12562
+ "operationId": "putConnectionMemory",
12563
+ "security": [
12564
+ {
12565
+ "BearerAuth": []
12566
+ }
12567
+ ],
12568
+ "parameters": [
12569
+ {
12570
+ "in": "path",
12571
+ "name": "connectionId",
12572
+ "required": true,
12573
+ "schema": {
12574
+ "type": "string",
12575
+ "format": "uuid"
12576
+ }
12577
+ },
12578
+ {
12579
+ "in": "path",
12580
+ "name": "namespace",
12581
+ "required": true,
12582
+ "schema": {
12583
+ "type": "string"
12584
+ }
12585
+ },
12586
+ {
12587
+ "in": "path",
12588
+ "name": "key",
12589
+ "required": true,
12590
+ "schema": {
12591
+ "type": "string"
12592
+ }
12593
+ },
12594
+ {
12595
+ "in": "query",
12596
+ "name": "agent_id",
12597
+ "required": false,
12598
+ "schema": {
12599
+ "type": "string",
12600
+ "format": "uuid"
12601
+ }
12602
+ }
12603
+ ],
12604
+ "requestBody": {
12605
+ "required": true,
12606
+ "content": {
12607
+ "application/json": {
12608
+ "schema": {
12609
+ "$ref": "#/components/schemas/PutMemoryRequest"
12610
+ }
12611
+ }
12612
+ }
12613
+ },
12614
+ "responses": {
12615
+ "200": {
12616
+ "description": "Memory entry stored",
12617
+ "content": {
12618
+ "application/json": {
12619
+ "schema": {
12620
+ "$ref": "#/components/schemas/MemoryEntry"
12621
+ }
12622
+ }
12623
+ }
12624
+ }
12625
+ }
12626
+ },
11825
12627
  "delete": {
11826
12628
  "tags": [
11827
12629
  "Platform"
11828
12630
  ],
11829
- "summary": "Deactivate a signing key for a connection agent",
11830
- "description": "Deactivates the signing key for an agent provisioned on the connection.\nWhen multiple agents exist, pass `agent_id` query param. plt_ auth only.\n",
11831
- "operationId": "deactivateConnectionSigningKey",
12631
+ "summary": "Delete agent memory entry (connection-scoped)",
12632
+ "operationId": "deleteConnectionMemory",
11832
12633
  "security": [
11833
12634
  {
11834
12635
  "BearerAuth": []
@@ -11846,7 +12647,15 @@
11846
12647
  },
11847
12648
  {
11848
12649
  "in": "path",
11849
- "name": "chain",
12650
+ "name": "namespace",
12651
+ "required": true,
12652
+ "schema": {
12653
+ "type": "string"
12654
+ }
12655
+ },
12656
+ {
12657
+ "in": "path",
12658
+ "name": "key",
11850
12659
  "required": true,
11851
12660
  "schema": {
11852
12661
  "type": "string"
@@ -11864,10 +12673,7 @@
11864
12673
  ],
11865
12674
  "responses": {
11866
12675
  "204": {
11867
- "description": "Key deactivated"
11868
- },
11869
- "400": {
11870
- "description": "Multiple agents — agent_id required"
12676
+ "description": "Deleted"
11871
12677
  },
11872
12678
  "404": {
11873
12679
  "$ref": "#/components/responses/NotFound"
@@ -22758,6 +23564,93 @@
22758
23564
  }
22759
23565
  }
22760
23566
  },
23567
+ "ConnectionSigningKeyPublic": {
23568
+ "type": "object",
23569
+ "properties": {
23570
+ "chain": {
23571
+ "type": "string"
23572
+ },
23573
+ "address": {
23574
+ "type": "string"
23575
+ },
23576
+ "public_key": {
23577
+ "type": "string"
23578
+ },
23579
+ "curve": {
23580
+ "type": "string"
23581
+ }
23582
+ }
23583
+ },
23584
+ "ConnectionSigningKeyListResponse": {
23585
+ "type": "object",
23586
+ "properties": {
23587
+ "agent_id": {
23588
+ "type": "string",
23589
+ "format": "uuid"
23590
+ },
23591
+ "keys": {
23592
+ "type": "array",
23593
+ "items": {
23594
+ "$ref": "#/components/schemas/ConnectionSigningKeyPublic"
23595
+ }
23596
+ }
23597
+ }
23598
+ },
23599
+ "ConnectionSigningKeyDetailResponse": {
23600
+ "type": "object",
23601
+ "properties": {
23602
+ "agent_id": {
23603
+ "type": "string",
23604
+ "format": "uuid"
23605
+ },
23606
+ "chain": {
23607
+ "type": "string"
23608
+ },
23609
+ "address": {
23610
+ "type": "string"
23611
+ },
23612
+ "public_key": {
23613
+ "type": "string"
23614
+ },
23615
+ "curve": {
23616
+ "type": "string"
23617
+ }
23618
+ }
23619
+ },
23620
+ "PatchConnectionAgentRequest": {
23621
+ "type": "object",
23622
+ "properties": {
23623
+ "intents_api_enabled": {
23624
+ "type": "boolean"
23625
+ },
23626
+ "execution_intents_enabled": {
23627
+ "type": "boolean"
23628
+ },
23629
+ "system_prompt": {
23630
+ "type": "string",
23631
+ "nullable": true
23632
+ }
23633
+ }
23634
+ },
23635
+ "PatchConnectionAgentResponse": {
23636
+ "type": "object",
23637
+ "properties": {
23638
+ "agent_id": {
23639
+ "type": "string",
23640
+ "format": "uuid"
23641
+ },
23642
+ "intents_api_enabled": {
23643
+ "type": "boolean"
23644
+ },
23645
+ "execution_intents_enabled": {
23646
+ "type": "boolean"
23647
+ },
23648
+ "system_prompt": {
23649
+ "type": "string",
23650
+ "nullable": true
23651
+ }
23652
+ }
23653
+ },
22761
23654
  "LeaseBankrKeyRequest": {
22762
23655
  "type": "object",
22763
23656
  "properties": {
@@ -23725,6 +24618,82 @@
23725
24618
  }
23726
24619
  }
23727
24620
  },
24621
+ "OnboardingStatus": {
24622
+ "type": "object",
24623
+ "required": [
24624
+ "has_vault",
24625
+ "has_agent",
24626
+ "has_policy",
24627
+ "has_sample_secret",
24628
+ "first_secret_read",
24629
+ "welcome_bundle_complete"
24630
+ ],
24631
+ "properties": {
24632
+ "has_vault": {
24633
+ "type": "boolean"
24634
+ },
24635
+ "has_agent": {
24636
+ "type": "boolean"
24637
+ },
24638
+ "has_policy": {
24639
+ "type": "boolean"
24640
+ },
24641
+ "has_sample_secret": {
24642
+ "type": "boolean"
24643
+ },
24644
+ "first_secret_read": {
24645
+ "type": "boolean"
24646
+ },
24647
+ "welcome_bundle_complete": {
24648
+ "type": "boolean"
24649
+ },
24650
+ "default_vault_id": {
24651
+ "type": "string",
24652
+ "format": "uuid",
24653
+ "nullable": true
24654
+ }
24655
+ }
24656
+ },
24657
+ "OnboardingProvisionRequest": {
24658
+ "type": "object",
24659
+ "properties": {
24660
+ "agent_name": {
24661
+ "type": "string"
24662
+ },
24663
+ "client": {
24664
+ "type": "string"
24665
+ }
24666
+ }
24667
+ },
24668
+ "OnboardingProvisionResponse": {
24669
+ "type": "object",
24670
+ "required": [
24671
+ "agent_id",
24672
+ "api_key",
24673
+ "vault_id",
24674
+ "mcp_stdio_config",
24675
+ "verify_prompt"
24676
+ ],
24677
+ "properties": {
24678
+ "agent_id": {
24679
+ "type": "string",
24680
+ "format": "uuid"
24681
+ },
24682
+ "api_key": {
24683
+ "type": "string"
24684
+ },
24685
+ "vault_id": {
24686
+ "type": "string",
24687
+ "format": "uuid"
24688
+ },
24689
+ "mcp_stdio_config": {
24690
+ "type": "object"
24691
+ },
24692
+ "verify_prompt": {
24693
+ "type": "string"
24694
+ }
24695
+ }
24696
+ },
23728
24697
  "AgentKeysVaultResponse": {
23729
24698
  "type": "object",
23730
24699
  "properties": {
@@ -25915,6 +26884,11 @@
25915
26884
  "format": "date-time",
25916
26885
  "nullable": true,
25917
26886
  "description": "Optional expiration time for the platform API key. Set to null to clear."
26887
+ },
26888
+ "siwe_domain": {
26889
+ "type": "string",
26890
+ "nullable": true,
26891
+ "description": "Hostname allowed in SIWE messages for wallet sign-in (EIP-4361)."
25918
26892
  }
25919
26893
  }
25920
26894
  },
@@ -26055,6 +27029,11 @@
26055
27029
  "nullable": true,
26056
27030
  "description": "When the platform API key was last rotated."
26057
27031
  },
27032
+ "siwe_domain": {
27033
+ "type": "string",
27034
+ "nullable": true,
27035
+ "description": "Hostname allowed in SIWE messages for wallet sign-in (EIP-4361)."
27036
+ },
26058
27037
  "created_at": {
26059
27038
  "type": "string",
26060
27039
  "format": "date-time"
@@ -26099,7 +27078,7 @@
26099
27078
  },
26100
27079
  "spec": {
26101
27080
  "type": "object",
26102
- "description": "Template specification defining vault, agents, policies, and signing keys to bootstrap.\nTop-level fields: `vault` (object with name, description), `agents` (array of agent specs\nwith name, description, shroud_enabled, intents, shroud_config), `policies` (array with\nvault_ref, principal_ref, paths, permissions, conditions), and `signing_keys` (array of\n`{ chain }` objects — supported chains: ethereum, bitcoin, solana, xrp, cardano, tron).\nWhen `signing_keys` is present, HSM-backed signing keys are auto-provisioned for the\nbootstrapped agent.\n"
27081
+ "description": "Template specification defining vault, agents, policies, and signing keys to bootstrap.\nTop-level fields: `vault` (object with name, description), `agents` (array of agent specs),\n`policies` (array with vault_ref, principal_ref, paths, permissions, conditions), and\n`signing_keys` (array of `{ chain }` objects — supported chains: ethereum, bitcoin, solana,\nxrp, cardano, tron). When `signing_keys` is present, HSM-backed signing keys are\nauto-provisioned for the bootstrapped agent.\n\nEach agent entry accepts Intents API and Execution Intents flags under any of these aliases\n(direct API field name, boolean shorthand, or `{ enabled: true }` object):\n- Intents API → `intents_api_enabled`, `intents: true`, or `intents: { enabled: true }`\n (maps to `agents.intents_api_enabled`)\n- Execution Intents → `execution_intents_enabled`, `execution: true`, or\n `execution: { enabled: true }` (maps to `agents.execution_intents_enabled`)\n\nOther agent fields: `name`, `description`, `shroud_enabled`, `shroud_config`, `system_prompt`,\n`environment`, `signing_keys`, `provision_eoa`, `memory`, `runtime`, `default_llm_provider`.\n"
26103
27082
  }
26104
27083
  }
26105
27084
  },
@@ -32093,6 +33072,121 @@
32093
33072
  }
32094
33073
  }
32095
33074
  },
33075
+ "ConnectionSubmitPendingApprovalRequest": {
33076
+ "type": "object",
33077
+ "required": [
33078
+ "action_payload"
33079
+ ],
33080
+ "properties": {
33081
+ "agent_id": {
33082
+ "type": "string",
33083
+ "format": "uuid",
33084
+ "description": "Required when the connection has multiple agents"
33085
+ },
33086
+ "policy_id": {
33087
+ "type": "string",
33088
+ "format": "uuid",
33089
+ "description": "Optional — auto-resolved from agent consensus policies when omitted"
33090
+ },
33091
+ "action": {
33092
+ "type": "string",
33093
+ "default": "transaction"
33094
+ },
33095
+ "action_payload": {
33096
+ "type": "object",
33097
+ "description": "Transaction/intent fields (chain, to, value, …) hashed for decide binding"
33098
+ },
33099
+ "summary": {
33100
+ "type": "string",
33101
+ "description": "Human-readable label included in webhook payloads"
33102
+ }
33103
+ }
33104
+ },
33105
+ "InspectContentRequest": {
33106
+ "type": "object",
33107
+ "required": [
33108
+ "content"
33109
+ ],
33110
+ "properties": {
33111
+ "content": {
33112
+ "type": "string",
33113
+ "maxLength": 102400
33114
+ },
33115
+ "context": {
33116
+ "type": "string",
33117
+ "enum": [
33118
+ "input",
33119
+ "output"
33120
+ ],
33121
+ "description": "Inspection context (reserved for future rules)"
33122
+ }
33123
+ }
33124
+ },
33125
+ "InspectContentResponse": {
33126
+ "type": "object",
33127
+ "properties": {
33128
+ "safe": {
33129
+ "type": "boolean"
33130
+ },
33131
+ "verdict": {
33132
+ "type": "string",
33133
+ "enum": [
33134
+ "clean",
33135
+ "malicious"
33136
+ ]
33137
+ },
33138
+ "threat_count": {
33139
+ "type": "integer"
33140
+ },
33141
+ "threats": {
33142
+ "type": "array",
33143
+ "items": {
33144
+ "type": "object",
33145
+ "properties": {
33146
+ "type": {
33147
+ "type": "string"
33148
+ },
33149
+ "pattern": {
33150
+ "type": "string"
33151
+ },
33152
+ "severity": {
33153
+ "type": "string"
33154
+ }
33155
+ }
33156
+ }
33157
+ },
33158
+ "unicode_normalized": {
33159
+ "type": "boolean"
33160
+ },
33161
+ "normalized_content": {
33162
+ "type": "string"
33163
+ }
33164
+ }
33165
+ },
33166
+ "PlatformWebhookInfoResponse": {
33167
+ "type": "object",
33168
+ "properties": {
33169
+ "app_id": {
33170
+ "type": "string",
33171
+ "format": "uuid"
33172
+ },
33173
+ "webhook_configured": {
33174
+ "type": "boolean"
33175
+ },
33176
+ "webhook_url_host": {
33177
+ "type": "string"
33178
+ },
33179
+ "platform_events": {
33180
+ "type": "array",
33181
+ "items": {
33182
+ "type": "string"
33183
+ }
33184
+ },
33185
+ "org_webhooks_note": {
33186
+ "type": "string"
33187
+ }
33188
+ }
33189
+ },
32096
33190
  "SubmitPendingApprovalResponse": {
32097
33191
  "type": "object",
32098
33192
  "properties": {