From 8bac28544213bd6b88e3bf038b3fbe2fa700b0e0 Mon Sep 17 00:00:00 2001 From: martinforejt Date: Thu, 23 Oct 2025 14:46:27 +0200 Subject: [PATCH 1/2] docs: Update resource input field docs --- .../input_schema/specification.md | 35 ++++++++++++------- 1 file changed, 23 insertions(+), 12 deletions(-) diff --git a/sources/platform/actors/development/actor_definition/input_schema/specification.md b/sources/platform/actors/development/actor_definition/input_schema/specification.md index 236428ab3..58131f5f3 100644 --- a/sources/platform/actors/development/actor_definition/input_schema/specification.md +++ b/sources/platform/actors/development/actor_definition/input_schema/specification.md @@ -831,9 +831,9 @@ As with objects, the sub-schema feature for arrays only works for level 1 sub-pr Resource type identifies what kind of Apify Platform object is referred to in the input field. For example, the Key-value store resource type can be referred to using a string ID. Currently, it supports storage resources only, allowing the reference of a Dataset, Key-Value Store or Request Queue. -For Actor developers, the resource input value is a string representing the storage ID. -The type of the property is either `string` or `array`. In case of `array` (for multiple resources) the return value is an array of IDs. -In the user interface, a picker is provided for easy selection, where users can search and choose from their own storages or those they have access to. +For Actor developers, the resource input value is a string representing either the resource ID or (unique) name. +The type of the property is either `string` or `array`. In case of `array` (for multiple resources) the return value is an array of IDs or names. +In the user interface, a picker (`resourcePicker` editor) is provided for easy selection, where users can search and choose from their own resources or those they have access to. Example of a Dataset input: @@ -869,12 +869,23 @@ Rendered input: ![Apify Actor input schema datasets](./images/input-schema-datasets.png) -Properties: - -| Property | Value | Required | Description | -|----------------|-----------------------------------------------------------------------------------|----------|------------------------------------------------------------------------------------| -| `type` | One of | Yes | Specifies the type of input - string for single value or array for multiple values | -| `editor` | One of | No | Visual editor used for
the input field. Defaults to `resourcePicker`. | -| `resourceType` | One of | Yes | Type of Apify Platform resource | -| `minItems` | Integer | No | Minimum number of items the array can contain. Only for `type: array` | -| `maxItems` | Integer | No | Maximum number of items the array can contain. Only for `type: array` | +##### Single value properties + +| Property | Value | Required | Description | +|----------------|-----------------------------------------------------------------------------------|----------|----------------------------------------------------------------------------------------------------------| +| `type` | `string` | Yes | Specifies the type of input - `string` for single value. | +| `editor` | One of | No | Visual editor used for
the input field. Defaults to `resourcePicker`. | +| `resourceType` | One of | Yes | Type of Apify Platform resource | +| `pattern` | String | No | Regular expression that will be used to validate the input. If validation fails, the Actor will not run. | +| `minLength` | Integer | No | Minimum length of the string. | +| `maxLength` | Integer | No | Maximum length of the string. | + +##### Multiple values properties + +| Property | Value | Required | Description | +|----------------|-----------------------------------------------------------------------------------|----------|----------------------------------------------------------------------------| +| `type` | `array` | Yes | Specifies the type of input - `array` for multiple values. | +| `editor` | One of | No | Visual editor used for
the input field. Defaults to `resourcePicker`. | +| `resourceType` | One of | Yes | Type of Apify Platform resource | +| `minItems` | Integer | No | Minimum number of items the array can contain. | +| `maxItems` | Integer | No | Maximum number of items the array can contain. | From 1479635ae68977345ab1cef34472e00681e86da5 Mon Sep 17 00:00:00 2001 From: martinforejt Date: Thu, 23 Oct 2025 15:26:17 +0200 Subject: [PATCH 2/2] fix lint --- .../actor_definition/input_schema/specification.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sources/platform/actors/development/actor_definition/input_schema/specification.md b/sources/platform/actors/development/actor_definition/input_schema/specification.md index 58131f5f3..6e51c95a1 100644 --- a/sources/platform/actors/development/actor_definition/input_schema/specification.md +++ b/sources/platform/actors/development/actor_definition/input_schema/specification.md @@ -869,7 +869,7 @@ Rendered input: ![Apify Actor input schema datasets](./images/input-schema-datasets.png) -##### Single value properties +#### Single value properties | Property | Value | Required | Description | |----------------|-----------------------------------------------------------------------------------|----------|----------------------------------------------------------------------------------------------------------| @@ -880,7 +880,7 @@ Rendered input: | `minLength` | Integer | No | Minimum length of the string. | | `maxLength` | Integer | No | Maximum length of the string. | -##### Multiple values properties +#### Multiple values properties | Property | Value | Required | Description | |----------------|-----------------------------------------------------------------------------------|----------|----------------------------------------------------------------------------|