@wevion/cli 1.0.3932 → 1.0.3938

package/openapi.json

@@ -58005,6 +58005,16 @@
                                   }
                                 ]
                               },
+                              "tiktokMusicId": {
+                                "anyOf": [
+                                  {
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ]
+                              },
                               "tiktokOptimizeGoal": {
                                 "anyOf": [
                                   {
@@ -62666,6 +62676,16 @@
                                   }
                                 ]
                               },
+                              "tiktokMusicId": {
+                                "anyOf": [
+                                  {
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ]
+                              },
                               "tiktokOptimizeGoal": {
                                 "anyOf": [
                                   {
@@ -67228,6 +67248,16 @@
                                   }
                                 ]
                               },
+                              "tiktokMusicId": {
+                                "anyOf": [
+                                  {
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ]
+                              },
                               "tiktokOptimizeGoal": {
                                 "anyOf": [
                                   {
@@ -75783,6 +75813,16 @@
                                   }
                                 ]
                               },
+                              "tiktokMusicId": {
+                                "anyOf": [
+                                  {
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ]
+                              },
                               "tiktokOptimizeGoal": {
                                 "anyOf": [
                                   {
@@ -119503,6 +119543,10 @@
                   "name"
                 ],
                 "properties": {
+                  "character": {
+                    "maxLength": 4000,
+                    "type": "string"
+                  },
                   "mode": {
                     "anyOf": [
                       {
@@ -120361,24 +120405,39 @@
             }
           },
           "429": {
-            "description": "Too many requests - rate limit exceeded",
+            "description": "Rate limit exceeded for this route: retry after the seconds in the `retry-after` response header.",
             "content": {
               "application/json": {
                 "schema": {
                   "additionalProperties": false,
+                  "description": "Rate limit exceeded for this route: retry after the seconds in the `retry-after` response header.",
                   "type": "object",
                   "required": [
-                    "error"
+                    "statusCode",
+                    "error",
+                    "message"
                   ],
                   "properties": {
-                    "code": {
-                      "type": "string"
+                    "statusCode": {
+                      "type": "integer"
                     },
                     "error": {
                       "type": "string"
                     },
                     "message": {
                       "type": "string"
+                    },
+                    "code": {
+                      "description": "`API_KEY_RATE_LIMITED` when the exhausted quota is the API key own limit.",
+                      "type": "string"
+                    },
+                    "retry_after_seconds": {
+                      "description": "Seconds to wait before retrying, mirroring the `retry-after` header.",
+                      "type": "integer"
+                    },
+                    "request_id": {
+                      "description": "Request identifier, for support.",
+                      "type": "string"
                     }
                   }
                 }
@@ -121113,14 +121172,545 @@
         }
       }
     },
-    "/api/v1/creative-hub/avatars/{id}/confirm": {
+    "/api/v1/creative-hub/avatars/refine-prompt": {
       "post": {
-        "operationId": "postApiV1CreativeHubAvatarsByIdConfirm",
-        "summary": "Confirm a generated Creative Hub avatar",
+        "operationId": "refineCreativeHubAvatarPrompt",
+        "summary": "Rewrite a free-text avatar prompt into the structured character description",
         "tags": [
           "creative-hub"
         ],
-        "description": "Promotes a generated preview to a saved avatar. Only a preview owned by the authenticated user can be confirmed.",
+        "description": "Turns an informal description into the character description the avatar image prompt expects, covering age, complexion, hair, eyes, build, clothing and register. Generates nothing and charges no credits: the caller shows the result to the user, who edits it and decides whether to generate. Rate-limited per user because it reaches a paid model without charging.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "additionalProperties": false,
+                "type": "object",
+                "required": [
+                  "prompt"
+                ],
+                "properties": {
+                  "prompt": {
+                    "minLength": 1,
+                    "maxLength": 2000,
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "refined_prompt"
+                  ],
+                  "properties": {
+                    "refined_prompt": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "type": "string",
+                      "description": "Fastify request id, propagated for support correlation."
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Rate limit exceeded for this route: retry after the seconds in the `retry-after` response header.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "description": "Rate limit exceeded for this route: retry after the seconds in the `retry-after` response header.",
+                  "type": "object",
+                  "required": [
+                    "statusCode",
+                    "error",
+                    "message"
+                  ],
+                  "properties": {
+                    "statusCode": {
+                      "type": "integer"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "description": "`API_KEY_RATE_LIMITED` when the exhausted quota is the API key own limit.",
+                      "type": "string"
+                    },
+                    "retry_after_seconds": {
+                      "description": "Seconds to wait before retrying, mirroring the `retry-after` header.",
+                      "type": "integer"
+                    },
+                    "request_id": {
+                      "description": "Request identifier, for support.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Service unavailable",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/creative-hub/avatars/{id}/cancel-edit": {
+      "post": {
+        "operationId": "postApiV1CreativeHubAvatarsByIdCancelEdit",
+        "summary": "Cancel an in-progress edit of a saved Creative Hub avatar",
+        "tags": [
+          "creative-hub"
+        ],
+        "description": "Restores a saved avatar to the shots it had before the edit was started, and puts it back in the library. Only an avatar with a pending restore point can be cancelled; a freshly generated preview has nothing to go back to and is discarded with DELETE instead.",
+        "parameters": [
+          {
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            },
+            "in": "path",
+            "name": "id",
+            "required": true
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "team_id",
+                    "created_by",
+                    "name",
+                    "gender",
+                    "age_bracket",
+                    "scenario",
+                    "image_url",
+                    "thumbnail_url",
+                    "preview_video_url",
+                    "prompt",
+                    "voice_id",
+                    "provider",
+                    "provider_avatar_ref",
+                    "is_library",
+                    "status",
+                    "tags",
+                    "metadata",
+                    "created_at",
+                    "updated_at",
+                    "deleted_at"
+                  ],
+                  "properties": {
+                    "id": {
+                      "format": "uuid",
+                      "type": "string"
+                    },
+                    "team_id": {
+                      "anyOf": [
+                        {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "created_by": {
+                      "anyOf": [
+                        {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "gender": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "age_bracket": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "scenario": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "image_url": {
+                      "type": "string"
+                    },
+                    "thumbnail_url": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "preview_video_url": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "prompt": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "voice_id": {
+                      "anyOf": [
+                        {
+                          "format": "uuid",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "provider": {
+                      "type": "string"
+                    },
+                    "provider_avatar_ref": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "is_library": {
+                      "type": "boolean"
+                    },
+                    "status": {
+                      "type": "string"
+                    },
+                    "tags": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "metadata": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "$comment": "json-value"
+                      }
+                    },
+                    "created_at": {
+                      "format": "date-time",
+                      "type": "string"
+                    },
+                    "updated_at": {
+                      "format": "date-time",
+                      "type": "string"
+                    },
+                    "deleted_at": {
+                      "anyOf": [
+                        {
+                          "format": "date-time",
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "request_id": {
+                      "type": "string",
+                      "description": "Fastify request id, propagated for support correlation."
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Forbidden - caller lacks the required role/permission",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Conflict - resource state prevents the operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    },
+                    "error": {
+                      "type": "string"
+                    },
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
+                "schema": {
+                  "type": "integer"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/v1/creative-hub/avatars/{id}/confirm": {
+      "post": {
+        "operationId": "postApiV1CreativeHubAvatarsByIdConfirm",
+        "summary": "Confirm a generated Creative Hub avatar",
+        "tags": [
+          "creative-hub"
+        ],
+        "description": "Promotes a generated preview to a saved avatar. Only a preview owned by the authenticated user can be confirmed.",
         "parameters": [
           {
             "schema": {
@@ -121447,7 +122037,7 @@
         "tags": [
           "creative-hub"
         ],
-        "description": "Runs the generation again on the traits already stored for the preview. An optional feedback note is appended to the previous free text instead of replacing it. Charges the generation again.",
+        "description": "Runs the generation again on the traits already stored for the avatar. Accepts both a not-yet-saved preview and an avatar already in the library: on a saved one this is the post-hoc edit, and the previous shots are kept as a restore point until the result is confirmed or cancelled. An optional feedback note is appended to the previous free text instead of replacing it. Charges the generation again.",
         "requestBody": {
           "required": true,
           "content": {
@@ -121629,24 +122219,39 @@
             }
           },
           "429": {
-            "description": "Too many requests - rate limit exceeded",
+            "description": "Rate limit exceeded for this route: retry after the seconds in the `retry-after` response header.",
             "content": {
               "application/json": {
                 "schema": {
                   "additionalProperties": false,
+                  "description": "Rate limit exceeded for this route: retry after the seconds in the `retry-after` response header.",
                   "type": "object",
                   "required": [
-                    "error"
+                    "statusCode",
+                    "error",
+                    "message"
                   ],
                   "properties": {
-                    "code": {
-                      "type": "string"
+                    "statusCode": {
+                      "type": "integer"
                     },
                     "error": {
                       "type": "string"
                     },
                     "message": {
                       "type": "string"
+                    },
+                    "code": {
+                      "description": "`API_KEY_RATE_LIMITED` when the exhausted quota is the API key own limit.",
+                      "type": "string"
+                    },
+                    "retry_after_seconds": {
+                      "description": "Seconds to wait before retrying, mirroring the `retry-after` header.",
+                      "type": "integer"
+                    },
+                    "request_id": {
+                      "description": "Request identifier, for support.",
+                      "type": "string"
                     }
                   }
                 }
@@ -131732,7 +132337,7 @@
           "creative-hub",
           "creative-library"
         ],
-        "description": "Lists Creative Hub assets for the active team with optional kind, folder and search filters. Results are cursor-paginated.",
+        "description": "Lists Creative Hub assets for the active team with optional kind, folder, search and producer filters. Results are cursor-paginated.",
         "parameters": [
           {
             "schema": {
@@ -131759,6 +132364,18 @@
             "name": "search",
             "required": false
           },
+          {
+            "schema": {
+              "type": "string",
+              "enum": [
+                "subtitles"
+              ]
+            },
+            "in": "query",
+            "name": "produced_by",
+            "required": false,
+            "description": "Only assets produced by this Creative Hub pipeline."
+          },
           {
             "schema": {
               "type": "string"
@@ -132604,6 +133221,235 @@
       }
     },
     "/api/v1/creative-hub/library/assets/{id}": {
+      "get": {
+        "operationId": "creativeHubGetAsset",
+        "summary": "Get one Creative Hub library asset",
+        "tags": [
+          "creative-hub",
+          "creative-library"
+        ],
+        "description": "Returns one Creative Hub library asset in the active team. Answers 404 when the asset does not exist or is outside the caller scope, so a guessed id cannot tell the two apart.",
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "path",
+            "name": "id",
+            "required": true
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "id",
+                    "name",
+                    "kind",
+                    "url",
+                    "thumbnail_url",
+                    "format",
+                    "width",
+                    "height",
+                    "duration",
+                    "size_bytes",
+                    "folder_id",
+                    "source",
+                    "provider",
+                    "metadata",
+                    "created_at"
+                  ],
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "kind": {
+                      "type": "string"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "thumbnail_url": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "format": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "width": {
+                      "anyOf": [
+                        {
+                          "type": "integer"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "height": {
+                      "anyOf": [
+                        {
+                          "type": "integer"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "duration": {
+                      "anyOf": [
+                        {
+                          "type": "number"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "size_bytes": {
+                      "anyOf": [
+                        {
+                          "type": "integer"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "folder_id": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "source": {
+                      "type": "string"
+                    },
+                    "provider": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "metadata": {
+                      "description": "JSON object with nested arrays and objects.",
+                      "type": "object",
+                      "additionalProperties": {
+                        "$comment": "json-value",
+                        "description": "Arbitrary JSON value with nested arrays and objects."
+                      }
+                    },
+                    "created_at": {
+                      "format": "date-time",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
+                "schema": {
+                  "type": "integer"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
       "patch": {
         "operationId": "creativeHubRenameAsset",
         "summary": "Rename a Creative Hub library asset",
@@ -367323,6 +368169,145 @@
         }
       }
     },
+    "/api/v1/tiktok/music": {
+      "get": {
+        "operationId": "listTikTokMusic",
+        "summary": "List TikTok music tracks usable in carousel ads",
+        "tags": [
+          "tiktok"
+        ],
+        "description": "Returns tracks valid for Carousel Ads (`music_scene: CAROUSEL_ADS`). With `q`, searches the Commercial Music Library by keyword; without it, returns the tracks uploaded to the advertiser account. `meta` exposes `author` and `cover_url`.",
+        "parameters": [
+          {
+            "schema": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "in": "query",
+            "name": "advertiser_id",
+            "required": true
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "in": "query",
+            "name": "q",
+            "required": false
+          }
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "apiKeyAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "items"
+                  ],
+                  "properties": {
+                    "items": {
+                      "type": "array",
+                      "items": {
+                        "additionalProperties": false,
+                        "type": "object",
+                        "required": [
+                          "id",
+                          "name"
+                        ],
+                        "properties": {
+                          "id": {
+                            "type": "string"
+                          },
+                          "name": {
+                            "type": "string"
+                          },
+                          "meta": {
+                            "description": "Free-form per-resource metadata (varies by endpoint, see description).",
+                            "type": "object",
+                            "additionalProperties": {
+                              "$comment": "json-value",
+                              "description": "Arbitrary JSON value with nested arrays and objects."
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request - schema validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "additionalProperties": false,
+                  "type": "object",
+                  "required": [
+                    "error"
+                  ],
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid bearer token",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too many requests - rate limit exceeded. Reachable on every API-key operation: the per-key cap sold with the plan answers `code: API_KEY_RATE_LIMITED` with `retry_after_seconds` and the `Retry-After` header. The global per-IP limiter can answer here too, with the same status and only `statusCode`, `error` and `message`.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitedResponse"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Session revocation check unavailable (Redis): retry after the Retry-After header.",
+            "headers": {
+              "Retry-After": {
+                "description": "Seconds to wait before retrying the identical request.",
+                "schema": {
+                  "type": "integer"
+                }
+              }
+            },
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/v1/tiktok/apps": {
       "get": {
         "operationId": "listTikTokApps",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wevion/cli",
-  "version": "1.0.3932",
+  "version": "1.0.3938",
   "description": "Wevion API command-line interface — generated from the public OpenAPI spec",
   "type": "module",
   "bin": {