@1claw/openapi-spec 0.26.0 → 0.27.0

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 (3) hide show
  1. package/openapi.json +114 -1
  2. package/openapi.yaml +81 -1
  3. package/package.json +2 -2
package/openapi.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "openapi": "3.1.0",
3
3
  "info": {
4
4
  "title": "1Claw API",
5
- "version": "2.14.0",
5
+ "version": "2.15.0",
6
6
  "description": "Secure secret management for AI agents. Provides vaults, secrets,\npolicy-based access control, agent identity, Intents API,\nsharing, billing, and audit logging.\n\nAll endpoints require JWT Bearer authentication unless marked with\n`security: []`.\n",
7
7
  "contact": {
8
8
  "email": "ops@1claw.xyz"
@@ -6165,6 +6165,77 @@
6165
6165
  }
6166
6166
  }
6167
6167
  },
6168
+ "/v1/platform/apps/{appId}/rotate-key": {
6169
+ "post": {
6170
+ "tags": [
6171
+ "Platform"
6172
+ ],
6173
+ "summary": "Rotate platform API key",
6174
+ "description": "Generate a new API key for the platform app. The old key is immediately invalidated. Returns the new key (one-time).",
6175
+ "security": [
6176
+ {
6177
+ "BearerAuth": []
6178
+ }
6179
+ ],
6180
+ "parameters": [
6181
+ {
6182
+ "name": "appId",
6183
+ "in": "path",
6184
+ "required": true,
6185
+ "schema": {
6186
+ "type": "string",
6187
+ "format": "uuid"
6188
+ }
6189
+ }
6190
+ ],
6191
+ "requestBody": {
6192
+ "content": {
6193
+ "application/json": {
6194
+ "schema": {
6195
+ "type": "object",
6196
+ "properties": {
6197
+ "api_key_expires_at": {
6198
+ "type": "string",
6199
+ "format": "date-time",
6200
+ "nullable": true,
6201
+ "description": "Optional expiration for the new key."
6202
+ }
6203
+ }
6204
+ }
6205
+ }
6206
+ }
6207
+ },
6208
+ "responses": {
6209
+ "200": {
6210
+ "description": "New key generated",
6211
+ "content": {
6212
+ "application/json": {
6213
+ "schema": {
6214
+ "type": "object",
6215
+ "properties": {
6216
+ "api_key": {
6217
+ "type": "string",
6218
+ "description": "The new API key (shown once)"
6219
+ },
6220
+ "api_key_prefix": {
6221
+ "type": "string"
6222
+ },
6223
+ "api_key_expires_at": {
6224
+ "type": "string",
6225
+ "format": "date-time",
6226
+ "nullable": true
6227
+ }
6228
+ }
6229
+ }
6230
+ }
6231
+ }
6232
+ },
6233
+ "403": {
6234
+ "description": "Only human users can rotate platform keys"
6235
+ }
6236
+ }
6237
+ }
6238
+ },
6168
6239
  "/v1/platform/apps/{appId}/templates": {
6169
6240
  "post": {
6170
6241
  "tags": [
@@ -8207,6 +8278,12 @@
8207
8278
  },
8208
8279
  "shroud_config": {
8209
8280
  "$ref": "#/components/schemas/ShroudConfig"
8281
+ },
8282
+ "api_key_expires_at": {
8283
+ "type": "string",
8284
+ "format": "date-time",
8285
+ "nullable": true,
8286
+ "description": "Optional expiration time for the agent's API key."
8210
8287
  }
8211
8288
  }
8212
8289
  },
@@ -8286,6 +8363,12 @@
8286
8363
  "maximum": 3600,
8287
8364
  "nullable": true,
8288
8365
  "description": "Per-agent TTL override for federation tokens (seconds). NULL falls\nback to the global default (`ONECLAW_JWT_FEDERATED_TOKEN_EXPIRY_SECS`).\nHard-capped at 3600 seconds.\n"
8366
+ },
8367
+ "api_key_expires_at": {
8368
+ "type": "string",
8369
+ "format": "date-time",
8370
+ "nullable": true,
8371
+ "description": "Optional expiration time for the agent's API key. Set to null to clear."
8289
8372
  }
8290
8373
  }
8291
8374
  },
@@ -8434,6 +8517,12 @@
8434
8517
  "type": "boolean",
8435
8518
  "description": "Whether EIP-191 personal_sign is enabled."
8436
8519
  },
8520
+ "api_key_expires_at": {
8521
+ "type": "string",
8522
+ "format": "date-time",
8523
+ "nullable": true,
8524
+ "description": "Optional expiration time for the agent's API key."
8525
+ },
8437
8526
  "created_at": {
8438
8527
  "type": "string",
8439
8528
  "format": "date-time"
@@ -11386,6 +11475,12 @@
11386
11475
  "max_connected_users": {
11387
11476
  "type": "integer",
11388
11477
  "nullable": true
11478
+ },
11479
+ "api_key_expires_at": {
11480
+ "type": "string",
11481
+ "format": "date-time",
11482
+ "nullable": true,
11483
+ "description": "Optional expiration time for the platform API key."
11389
11484
  }
11390
11485
  }
11391
11486
  },
@@ -11442,6 +11537,12 @@
11442
11537
  },
11443
11538
  "is_active": {
11444
11539
  "type": "boolean"
11540
+ },
11541
+ "api_key_expires_at": {
11542
+ "type": "string",
11543
+ "format": "date-time",
11544
+ "nullable": true,
11545
+ "description": "Optional expiration time for the platform API key. Set to null to clear."
11445
11546
  }
11446
11547
  }
11447
11548
  },
@@ -11507,6 +11608,18 @@
11507
11608
  "connected_users": {
11508
11609
  "type": "integer"
11509
11610
  },
11611
+ "api_key_expires_at": {
11612
+ "type": "string",
11613
+ "format": "date-time",
11614
+ "nullable": true,
11615
+ "description": "When the platform API key expires."
11616
+ },
11617
+ "api_key_rotated_at": {
11618
+ "type": "string",
11619
+ "format": "date-time",
11620
+ "nullable": true,
11621
+ "description": "When the platform API key was last rotated."
11622
+ },
11510
11623
  "created_at": {
11511
11624
  "type": "string",
11512
11625
  "format": "date-time"
package/openapi.yaml CHANGED
@@ -2,7 +2,7 @@ openapi: 3.1.0
2
2
 
3
3
  info:
4
4
  title: 1Claw API
5
- version: 2.14.0
5
+ version: 2.15.0
6
6
  description: |
7
7
  Secure secret management for AI agents. Provides vaults, secrets,
8
8
  policy-based access control, agent identity, Intents API,
@@ -4006,6 +4006,51 @@ paths:
4006
4006
  "403":
4007
4007
  description: Only human users can delete platform apps
4008
4008
 
4009
+ /v1/platform/apps/{appId}/rotate-key:
4010
+ post:
4011
+ tags: [Platform]
4012
+ summary: Rotate platform API key
4013
+ description: Generate a new API key for the platform app. The old key is immediately invalidated. Returns the new key (one-time).
4014
+ security:
4015
+ - BearerAuth: []
4016
+ parameters:
4017
+ - name: appId
4018
+ in: path
4019
+ required: true
4020
+ schema:
4021
+ type: string
4022
+ format: uuid
4023
+ requestBody:
4024
+ content:
4025
+ application/json:
4026
+ schema:
4027
+ type: object
4028
+ properties:
4029
+ api_key_expires_at:
4030
+ type: string
4031
+ format: date-time
4032
+ nullable: true
4033
+ description: Optional expiration for the new key.
4034
+ responses:
4035
+ "200":
4036
+ description: New key generated
4037
+ content:
4038
+ application/json:
4039
+ schema:
4040
+ type: object
4041
+ properties:
4042
+ api_key:
4043
+ type: string
4044
+ description: The new API key (shown once)
4045
+ api_key_prefix:
4046
+ type: string
4047
+ api_key_expires_at:
4048
+ type: string
4049
+ format: date-time
4050
+ nullable: true
4051
+ "403":
4052
+ description: Only human users can rotate platform keys
4053
+
4009
4054
  /v1/platform/apps/{appId}/templates:
4010
4055
  post:
4011
4056
  tags: [Platform]
@@ -5393,6 +5438,11 @@ components:
5393
5438
  description: Enable Shroud LLM Proxy for this agent
5394
5439
  shroud_config:
5395
5440
  $ref: "#/components/schemas/ShroudConfig"
5441
+ api_key_expires_at:
5442
+ type: string
5443
+ format: date-time
5444
+ nullable: true
5445
+ description: Optional expiration time for the agent's API key.
5396
5446
 
5397
5447
  UpdateAgentRequest:
5398
5448
  type: object
@@ -5459,6 +5509,11 @@ components:
5459
5509
  Per-agent TTL override for federation tokens (seconds). NULL falls
5460
5510
  back to the global default (`ONECLAW_JWT_FEDERATED_TOKEN_EXPIRY_SECS`).
5461
5511
  Hard-capped at 3600 seconds.
5512
+ api_key_expires_at:
5513
+ type: string
5514
+ format: date-time
5515
+ nullable: true
5516
+ description: Optional expiration time for the agent's API key. Set to null to clear.
5462
5517
 
5463
5518
  AgentResponse:
5464
5519
  type: object
@@ -5566,6 +5621,11 @@ components:
5566
5621
  message_signing_enabled:
5567
5622
  type: boolean
5568
5623
  description: Whether EIP-191 personal_sign is enabled.
5624
+ api_key_expires_at:
5625
+ type: string
5626
+ format: date-time
5627
+ nullable: true
5628
+ description: Optional expiration time for the agent's API key.
5569
5629
  created_at:
5570
5630
  type: string
5571
5631
  format: date-time
@@ -7607,6 +7667,11 @@ components:
7607
7667
  max_connected_users:
7608
7668
  type: integer
7609
7669
  nullable: true
7670
+ api_key_expires_at:
7671
+ type: string
7672
+ format: date-time
7673
+ nullable: true
7674
+ description: Optional expiration time for the platform API key.
7610
7675
 
7611
7676
  UpdatePlatformAppRequest:
7612
7677
  type: object
@@ -7641,6 +7706,11 @@ components:
7641
7706
  nullable: true
7642
7707
  is_active:
7643
7708
  type: boolean
7709
+ api_key_expires_at:
7710
+ type: string
7711
+ format: date-time
7712
+ nullable: true
7713
+ description: Optional expiration time for the platform API key. Set to null to clear.
7644
7714
 
7645
7715
  PlatformAppResponse:
7646
7716
  type: object
@@ -7687,6 +7757,16 @@ components:
7687
7757
  nullable: true
7688
7758
  connected_users:
7689
7759
  type: integer
7760
+ api_key_expires_at:
7761
+ type: string
7762
+ format: date-time
7763
+ nullable: true
7764
+ description: When the platform API key expires.
7765
+ api_key_rotated_at:
7766
+ type: string
7767
+ format: date-time
7768
+ nullable: true
7769
+ description: When the platform API key was last rotated.
7690
7770
  created_at:
7691
7771
  type: string
7692
7772
  format: date-time
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@1claw/openapi-spec",
3
- "version": "0.26.0",
3
+ "version": "0.27.0",
4
4
  "description": "OpenAPI 3.1.0 specification for the 1Claw Vault API \u2014 generate clients in any language",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -37,4 +37,4 @@
37
37
  "devDependencies": {
38
38
  "js-yaml": "^4.1.1"
39
39
  }
40
- }
40
+ }