docs: Add more info about free users #2150

patrikbraborec · 2025-12-17T08:42:34Z

Note

Adds documentation on transparently handling free-plan limitations, including using status messages and graceful exits.

Docs: Handling free users / limitations
- Add "Communicating limitations" to platform/actors/development/programming_interface/status_messages.md with guidance to:
  - Use setStatusMessage/exit messages to explain early finishes or failures.
  - Avoid misleading system-like errors.
  - Document limits in README and input schema.
- Add "Handling free users" to platform/actors/publishing/monetize/index.mdx covering:
  - Upfront communication of limits.
  - Graceful exits with clear status messages (linked section).
  - Avoiding confusion by not presenting policy limits as platform errors.

^{Written by Cursor Bugbot for commit 803f9d6. Configure here.}

apify-service-account · 2025-12-17T08:45:52Z

Preview for this PR was built for commit 803f9d6 and is ready at https://pr-2150.preview.docs.apify.com!

apify-service-account · 2025-12-17T08:49:05Z

Preview for this PR was built for commit 911fa3c and is ready at https://pr-2150.preview.docs.apify.com!

apify-service-account · 2025-12-17T08:54:30Z

Preview for this PR was built for commit 449beba and is ready at https://pr-2150.preview.docs.apify.com!

apify-service-account · 2025-12-17T08:58:01Z

Preview for this PR was built for commit 51f6094 and is ready at https://pr-2150.preview.docs.apify.com!

apify-service-account · 2025-12-17T09:19:55Z

Preview for this PR was built for commit 3358426 and is ready at https://pr-2150.preview.docs.apify.com!

metalwarrior665

I added a few suggestions to be more perscriptive so devs do this correctly. Feel free to rephrase me.

sources/platform/actors/development/programming_interface/status_messages.md

…us_messages.md Co-authored-by: Lukáš Křivka <lukaskrivka@gmail.com>

patrikbraborec · 2026-01-05T11:33:45Z

@metalwarrior665 thanks for review. @TC-MO can you please review it once you have time? Thanks

apify-service-account · 2026-01-05T11:36:15Z

Preview for this PR was built for commit 1d922474 and is ready at https://pr-2150.preview.docs.apify.com!

apify-service-account · 2026-01-05T11:39:39Z

Preview for this PR was built for commit 1d922474 and is ready at https://pr-2150.preview.docs.apify.com!

TC-MO

Requested few changes, some to address new content, and plea for standarization in already existing one to take advantage of this PR

sources/platform/actors/publishing/monetize/index.mdx

sources/platform/actors/development/programming_interface/status_messages.md

sources/platform/actors/publishing/monetize/index.mdx

TC-MO · 2026-01-05T12:44:40Z

Also there seems to be indentantion issue in status messages doc that makes linter very mad

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

apify-service-account · 2026-01-05T14:04:45Z

Preview for this PR was built for commit 4be9fa8c and is ready at https://pr-2150.preview.docs.apify.com!

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

apify-service-account · 2026-01-05T14:08:44Z

Preview for this PR was built for commit f1defba0 and is ready at https://pr-2150.preview.docs.apify.com!

apify-service-account · 2026-01-05T14:12:35Z

Preview for this PR was built for commit f1defba0 and is ready at https://pr-2150.preview.docs.apify.com!

Corrected nested list item indentation to use 2 spaces instead of 4-5 spaces to comply with MD007 markdown linting rules. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

patrikbraborec · 2026-01-05T14:42:51Z

Thank you @metalwarrior665 and @TC-MO. I fixed the issues, I think we can merge it.

apify-service-account · 2026-01-05T14:45:12Z

Preview for this PR was built for commit 037f84f7 and is ready at https://pr-2150.preview.docs.apify.com!

metalwarrior665

Just one small change and you can merge

sources/platform/actors/development/programming_interface/status_messages.md

…us_messages.md Co-authored-by: Lukáš Křivka <lukaskrivka@gmail.com>

apify-service-account · 2026-01-06T15:37:12Z

Preview for this PR was built for commit 5a0f2af3 and is ready at https://pr-2150.preview.docs.apify.com!

apify-service-account · 2026-01-06T15:40:08Z

Preview for this PR was built for commit 5a0f2af3 and is ready at https://pr-2150.preview.docs.apify.com!

apify-service-account · 2026-01-07T08:59:20Z

Preview for this PR was built for commit 12632eff and is ready at https://pr-2150.preview.docs.apify.com!

docs: Add more info about free users

803f9d6

patrikbraborec requested a review from TC-MO as a code owner December 17, 2025 08:42

docs: Fix lint errors

911fa3c

patrikbraborec added 2 commits December 17, 2025 09:50

docs: Fix lint errors

449beba

docs: Change position of text

51f6094

docs: Fix formatting

3358426

github-actions bot assigned patrikbraborec Dec 17, 2025

github-actions bot added this to the 130th sprint - Cash & Community team milestone Dec 17, 2025

github-actions bot added the t-c&c Team covering store and finance matters. label Dec 17, 2025

metalwarrior665 requested changes Dec 22, 2025

View reviewed changes

patrikbraborec and others added 3 commits January 5, 2026 12:32

Update sources/platform/actors/development/programming_interface/stat…

9b6c323

…us_messages.md Co-authored-by: Lukáš Křivka <lukaskrivka@gmail.com>

Update sources/platform/actors/development/programming_interface/stat…

eab28a6

…us_messages.md Co-authored-by: Lukáš Křivka <lukaskrivka@gmail.com>

Update sources/platform/actors/development/programming_interface/stat…

1d92247

…us_messages.md Co-authored-by: Lukáš Křivka <lukaskrivka@gmail.com>

TC-MO requested changes Jan 5, 2026

View reviewed changes

Apply suggestions from code review

4be9fa8

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

patrikbraborec and others added 3 commits January 5, 2026 15:05

Update sources/platform/actors/publishing/monetize/index.mdx

bd090d0

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/publishing/monetize/index.mdx

3810a23

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

Update sources/platform/actors/publishing/monetize/index.mdx

f1defba

Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>

TC-MO approved these changes Jan 6, 2026

View reviewed changes

metalwarrior665 requested changes Jan 6, 2026

View reviewed changes

sources/platform/actors/development/programming_interface/status_messages.md Outdated Show resolved Hide resolved

patrikbraborec and others added 2 commits January 6, 2026 16:33

Merge branch 'master' into docs/free-users

8ee19f0

Update sources/platform/actors/development/programming_interface/stat…

5a0f2af

…us_messages.md Co-authored-by: Lukáš Křivka <lukaskrivka@gmail.com>

Merge branch 'master' into docs/free-users

12632ef

metalwarrior665 approved these changes Jan 7, 2026

View reviewed changes

patrikbraborec merged commit 890d837 into master Jan 7, 2026
10 checks passed

patrikbraborec deleted the docs/free-users branch January 7, 2026 15:16

docs: Add more info about free users #2150

docs: Add more info about free users #2150

Conversation

patrikbraborec commented Dec 17, 2025 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apify-service-account commented Dec 17, 2025

Uh oh!

apify-service-account commented Dec 17, 2025

Uh oh!

apify-service-account commented Dec 17, 2025

Uh oh!

apify-service-account commented Dec 17, 2025

Uh oh!

apify-service-account commented Dec 17, 2025

Uh oh!

metalwarrior665 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

patrikbraborec commented Jan 5, 2026

Uh oh!

apify-service-account commented Jan 5, 2026

Uh oh!

apify-service-account commented Jan 5, 2026

Uh oh!

TC-MO left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

TC-MO commented Jan 5, 2026

Uh oh!

apify-service-account commented Jan 5, 2026

Uh oh!

apify-service-account commented Jan 5, 2026

Uh oh!

apify-service-account commented Jan 5, 2026

Uh oh!

patrikbraborec commented Jan 5, 2026

Uh oh!

apify-service-account commented Jan 5, 2026

Uh oh!

metalwarrior665 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

apify-service-account commented Jan 6, 2026

Uh oh!

apify-service-account commented Jan 6, 2026

Uh oh!

apify-service-account commented Jan 7, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

patrikbraborec commented Dec 17, 2025 •

edited by cursor bot

Loading