docs: version field in /api/v1/scraper/run is now optional, defaults to latest

Author: Cowork 3P

public/openapi.json

@@ -1219,7 +1219,7 @@
           },
           "version": {
             "type": "string",
-            "description": "Scraper version. Must be copied from `/api/scraper` -> `data.version`.",
+            "description": "Scraper version. Optional — if omitted, defaults to the latest version.",
             "example": "v1.0.5"
           },
           "is_async": {
@@ -1239,7 +1239,6 @@
         },
         "required": [
           "scraper_slug",
-          "version",
           "is_async",
           "input"
         ]

src/content/docs/api/worker/run.mdx

@@ -1,4 +1,4 @@
----
+---
 title: Start Worker
 description: Start a Worker run.
 sidebar:
@@ -34,7 +34,7 @@ You can find it:
 
 ```json
 {
-    "scraper_slug": "YOUR_SCRAPER_SLUG",
+    "version": "YOUR_WORKER_VERSION",  // Optional — defaults to latest version
     "version": "YOUR_WORKER_VERSION",
     "input": {
         "parameters": {
@@ -65,7 +65,7 @@ You can find it:
 | Parameter    | Required | Type    | Description |
 | ------------ | -------- | ------- | ----------- |
 | scraper_slug | Yes      | string  | **Worker ID** — unique identifier for the Worker you want to run |
-| version      | Yes      | string  | Worker version |
+| version      | No       | string  | Worker version. If omitted, defaults to the latest version. |
 | input        | Yes      | object  | Input parameters |
 | is_async     | Yes      | boolean | `true`: async execution (default), `false`: sync execution (waits for completion) |
 | callback_url | No       | string  | Callback URL for receiving run results |
@@ -129,4 +129,4 @@ You can get the Worker version from:
 | code      | 0                          | Integer | Global status code    |
 | message   | success                    | String  | Response message      |
 | data      | -                          | Object  | Response payload      |
-| run_slug  | 01KSFDS8XWTJME33C08XMCR6B9 | String  | **Run Record ID** — unique identifier for this execution |
+| run_slug  | 01KSFDS8XWTJME33C08XMCR6B9 | String  | **Run Record ID** — unique identifier for this execution |

src/content/docs/integrations/workflows-and-notifications/n8n.md

@@ -1,4 +1,4 @@
----
+---
 title: n8n
 description: Connect CoreClaw to n8n workflows using the CoreClaw community node
 sidebar:
@@ -120,14 +120,14 @@ Start an asynchronous scraper run with custom parameters.
 | Field                 | Description                                                              |
 | --------------------- | ------------------------------------------------------------------------ |
 | **Scraper**           | Pick from the marketplace list, or paste a slug directly                 |
-| **Version**           | Scraper version string (required). Obtain from **Get Details** → version |
+| **Version**           | Scraper version string (optional — defaults to latest). Obtain from **Get Details** → version |
 | **Custom Parameters** | Scraper-specific input parameters as JSON (schema from Get Details)      |
 | **System Parameters** | Optional JSON overrides for cpus, memory, timeout, max charge, traffic   |
 | **Callback URL**      | Optional webhook URL for async notifications                             |
 
 
 :::caution
-**Version is required.** The node does not support "leave empty for latest". Always obtain the correct version string from **Get Details** first.
+**Version is optional.** If left empty, the platform uses the latest version automatically. To pin a specific version, obtain the version string from **Get Details** first.
 :::
 
 Get the `scraper_slug` (Worker Slug) from the Worker page in the [CoreClaw Console](https://console.coreclaw.com/store) or from the API (`GET /api/scraper?slug=<scraper_slug>`).
@@ -341,4 +341,4 @@ curl "https://openapi.coreclaw.com/api/scraper?slug=YOUR_SCRAPER_SLUG"
 ```
 
 The response contains `data.parameters.custom.properties` — each entry maps to an input field.
-</details>
+</details>

src/content/docs/user-guide/run-worker/api-calls.md

@@ -45,7 +45,7 @@ POST /api/v1/scraper/run
 ```json
 {
   "scraper_slug": "YOUR_SCRAPER_SLUG",
-  "version": "<version>",
+  "version": "<version>",  // Optional — defaults to latest version
   "input": {
     "parameters": {
       "system": {
@@ -86,9 +86,9 @@ When building `custom`:
 - Follow the declared `type`, nested structure, and array shape
 - Provide every field where `required: true`
 - If `custom` is empty or does not match, the API returns `400 Bad Request`
-
 ### How to get `version`
 
+`version` is optional. If omitted, the platform uses the latest version automatically. To pin a specific version, use one of the following sources:
 Use one of the following sources:
 
 - the Worker version shown on the Worker page

src/content/docs/zh-cn/api/worker/run.mdx

@@ -1,4 +1,4 @@
----
+---
 title: 运行 Worker
 description: 启动 Worker 运行
 sidebar:
@@ -36,7 +36,7 @@ import ApiPlayground from '../../../../../components/ApiPlayground.astro'
 ```json
 {
     "scraper_slug": "YOUR_SCRAPER_SLUG",
-    "version": "YOUR_WORKER_VERSION",
+    "version": "YOUR_WORKER_VERSION",  // 可选 — 默认使用最新版本
     "input": {
         "parameters": {
             "system": {
@@ -66,7 +66,7 @@ import ApiPlayground from '../../../../../components/ApiPlayground.astro'
 | 参数         | 必填 | 类型    | 说明 |
 | ------------ | ---- | ------- | ---- |
 | scraper_slug | 是   | string  | **Worker ID**——要运行的 Worker 的唯一标识符 |
-| version      | 是   | string  | Worker 版本 |
+| version      | 否   | string  | Worker 版本。如不填写，默认使用最新版本。 |
 | input        | 是   | object  | 输入参数 |
 | is_async     | 是   | boolean | `true`：异步执行（默认），`false`：同步执行（等待完成） |
 | callback_url | 否   | string  | 用于接收运行结果的回调地址 |
@@ -130,4 +130,4 @@ import ApiPlayground from '../../../../../components/ApiPlayground.astro'
 | code     | 0                          | Integer | 全局状态码     |
 | message  | success                    | String  | 响应消息       |
 | data     | -                          | Object  | 响应数据       |
-| run_slug | 01KSFDS8XWTJME33C08XMCR6B9 | String  | **运行记录 ID**——本次执行的唯一标识符 |
+| run_slug | 01KSFDS8XWTJME33C08XMCR6B9 | String  | **运行记录 ID**——本次执行的唯一标识符 |

src/content/docs/zh-cn/integrations/workflows-and-notifications/n8n.md

@@ -1,4 +1,4 @@
----
+---
 title: n8n
 description: 使用 CoreClaw 社区节点将 CoreClaw 接入 n8n 工作流
 sidebar:
@@ -115,13 +115,13 @@ CoreClaw 节点按**资源**（Scraper、Run、Task、Account）组织。先选
 | 字段 | 说明 |
 |------|------|
 | **Scraper** | 从商店列表中选择，或直接粘贴 slug |
-| **Version** | 爬虫版本字符串（必填）。从 **Get Details** → version 获取 |
+| **Version** | 爬虫版本字符串（可选 — 默认使用最新版）。从 **Get Details** → version 获取 |
 | **Custom Parameters** | 爬虫特有的输入参数 JSON（schema 来自 Get Details） |
 | **System Parameters** | 可选 JSON，覆盖 cpus、memory、timeout、max charge、traffic |
 | **Callback URL** | 可选，异步通知的 Webhook 地址 |
 
 :::caution
-**Version 是必填字段。** 节点不支持"留空使用最新版"。务必先从 **Get Details** 获取正确的版本号。
+**Version 为可选字段。** 如不填写，平台将自动使用最新版本。如需指定版本，请先从 **Get Details** 获取版本号。
 :::
 
 `scraper_slug`（Worker Slug）可从 [CoreClaw 控制台](https://console.coreclaw.com/store)的 Worker 页面获取，或通过 API 查询（`GET /api/scraper?slug=<scraper_slug>`）。
@@ -315,4 +315,4 @@ curl "https://openapi.coreclaw.com/api/scraper?slug=YOUR_SCRAPER_SLUG"
 ```
 
 响应中的 `data.parameters.custom.properties` — 每个条目对应一个输入字段。
-</details>
+</details>

src/content/docs/zh-cn/user-guide/run-worker/api-calls.md

@@ -45,7 +45,7 @@ POST /api/v1/scraper/run
 ```json
 {
   "scraper_slug": "YOUR_SCRAPER_SLUG",
-  "version": "<version>",
+  "version": "<version>",  // 可选 — 默认使用最新版本
   "input": {
     "parameters": {
       "system": {
@@ -87,8 +87,8 @@ POST /api/v1/scraper/run
 - 对于 `required: true` 的字段，必须显式提供
 - 如果 `custom` 为空，或结构不匹配，接口会返回 `400 Bad Request`
 
-### 如何获取 `version`
 
+`version` 为可选字段。如不填写，平台将自动使用最新版本。如需指定版本，可通过以下方式获取：
 可以从以下位置获得：
 
 - Worker 页面显示的版本号