diff --git a/src/content/docs/workflows/build/workers-api.mdx b/src/content/docs/workflows/build/workers-api.mdx index 78c21d3e661959f..0a02b3353d2c655 100644 --- a/src/content/docs/workflows/build/workers-api.mdx +++ b/src/content/docs/workflows/build/workers-api.mdx @@ -173,7 +173,7 @@ Create (trigger) a new instance of the given Workflow. * `options` - optional properties to pass when creating an instance. -An ID is automatically generated, but a user-provided ID can be specified. This can be useful when mapping Workflows to users, merchants or other identifiers in your system. +An ID is automatically generated, but a user-provided ID can be specified (limited to 64 characters [^1]). This can be useful when mapping Workflows to users, merchants or other identifiers in your system. ```ts // Create a new Workflow instance with your own ID: @@ -293,3 +293,5 @@ type InstanceStatus = { output?: object; }; ``` + +[^1]: Match pattern: _```^[a-zA-Z0-9_][a-zA-Z0-9-_]*$```_ diff --git a/src/content/docs/workflows/reference/limits.mdx b/src/content/docs/workflows/reference/limits.mdx index 83e24c98bc12653..fbbd75f098abcf4 100644 --- a/src/content/docs/workflows/reference/limits.mdx +++ b/src/content/docs/workflows/reference/limits.mdx @@ -16,8 +16,8 @@ Many limits are inherited from those applied to Workers scripts and as documente | ----------------------------------------- | ----------------------- | --------------------- | | Workflow class definitions per script | 1MB max script size per [Worker size limits](/workers/platform/limits/#account-plan-limits) | 10MB max script size per [Worker size limits](/workers/platform/limits/#account-plan-limits) | Total scripts per account | 100 | 500 (shared with [Worker script limits](/workers/platform/limits/#account-plan-limits) | -| Compute time per Workflow | 10 seconds | 30 seconds of [active CPU time](/workers/platform/limits/#cpu-time) | -| Duration (wall clock) per `step` | Unlimited | Unlimited - e.g. waiting on network I/O calls or querying a database | +| Compute time per step [^3] | 10 seconds | 30 seconds of [active CPU time](/workers/platform/limits/#cpu-time) | +| Duration (wall clock) per step [^3] | Unlimited | Unlimited - for example, waiting on network I/O calls or querying a database | | Maximum persisted state per step | 1MiB (2^20 bytes) | 1MiB (2^20 bytes) | | Maximum state that can be persisted per Workflow instance | 100MB | 1GB | | Maximum `step.sleep` duration | 365 days (1 year) [^1] | @@ -25,10 +25,14 @@ Many limits are inherited from those applied to Workers scripts and as documente | Maximum Workflow executions | 100,000 per day [shared with Workers daily limit](/workers/platform/limits/#worker-limits) | Unlimited | | Concurrent Workflow instances (executions) | 25 | 100 [^1] | | Retention limit for completed Workflow state | 3 days | 30 days [^2] | -| Maximum length of a Workflow ID | 64 bytes | +| Maximum length of a Workflow ID [^4] | 64 characters | [^1]: This limit will be reviewed and revised during the open beta for Workflows. Follow the [Workflows changelog](/workflows/reference/changelog/) for updates. [^2]: Workflow state and logs will be retained for 3 days on the Workers Free plan and for 7 days on the Workers Paid plan. +[^3]: A Workflow instance can run forever, as long as each step does not take more than the CPU time limit and the maximum number of steps per Workflow is not reached. + +[^4]: Match pattern: _```^[a-zA-Z0-9_][a-zA-Z0-9-_]*$```_ +