From f43af135b38a02b6e8750f4d3085e5065e45887f Mon Sep 17 00:00:00 2001 From: "askold.tsentseus" Date: Mon, 29 Jun 2026 14:27:29 +0300 Subject: [PATCH 1/2] docs: add missing title and description properties to DatasetSchema object definition Fixes #2691 The DatasetSchema object definition table was missing the `title` and `description` properties that are used in examples (e.g., Academy tutorial with Zappos Scraper). These properties are valid and supported, but were not documented in the reference table. Added: - `title` (string, optional): Human-readable title for the dataset - `description` (string, optional): Description providing additional context These properties appear in the Output tab UI and API responses. Co-authored-by: Cursor --- .../actors/development/actor_definition/dataset_schema/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/sources/platform/actors/development/actor_definition/dataset_schema/index.md b/sources/platform/actors/development/actor_definition/dataset_schema/index.md index 3cee05779d..f127fb59e2 100644 --- a/sources/platform/actors/development/actor_definition/dataset_schema/index.md +++ b/sources/platform/actors/development/actor_definition/dataset_schema/index.md @@ -418,6 +418,8 @@ Alternatively, flatten nested structures in your Actor code before calling `Acto | Property | Type | Required | Description | | --- | --- | --- | --- | | `actorSpecification` | integer | true | Version of the dataset schema structure. Only version 1 is available. | +| `title` | string | false | Human-readable title for the dataset. Displayed in the Output tab UI and API responses. | +| `description` | string | false | Description of the dataset. Provides additional context in the Output tab UI and API responses. | | `fields` | JSONSchema object | false | Schema of one dataset object using JSON Schema Draft 2020-12 or compatible format. | | `views` | Object | true | An object containing view definitions. Each key is a view ID, each value is a DatasetView object. | From db88c531333b2cb2578924cd94f08b299969c13b Mon Sep 17 00:00:00 2001 From: "askold.tsentseus" Date: Mon, 29 Jun 2026 16:12:31 +0300 Subject: [PATCH 2/2] docs: simplify dataset schema title and description property descriptions Remove redundant information about UI and API display locations from property descriptions. Co-authored-by: Cursor --- .../development/actor_definition/dataset_schema/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sources/platform/actors/development/actor_definition/dataset_schema/index.md b/sources/platform/actors/development/actor_definition/dataset_schema/index.md index f127fb59e2..f51572b5fc 100644 --- a/sources/platform/actors/development/actor_definition/dataset_schema/index.md +++ b/sources/platform/actors/development/actor_definition/dataset_schema/index.md @@ -418,8 +418,8 @@ Alternatively, flatten nested structures in your Actor code before calling `Acto | Property | Type | Required | Description | | --- | --- | --- | --- | | `actorSpecification` | integer | true | Version of the dataset schema structure. Only version 1 is available. | -| `title` | string | false | Human-readable title for the dataset. Displayed in the Output tab UI and API responses. | -| `description` | string | false | Description of the dataset. Provides additional context in the Output tab UI and API responses. | +| `title` | string | false | Human-readable title for the dataset. | +| `description` | string | false | Description of the dataset. | | `fields` | JSONSchema object | false | Schema of one dataset object using JSON Schema Draft 2020-12 or compatible format. | | `views` | Object | true | An object containing view definitions. Each key is a view ID, each value is a DatasetView object. |