docs: fix high and medium inaccuracies in integrations pages#2727
Open
mtrunkat wants to merge 5 commits into
Open
docs: fix high and medium inaccuracies in integrations pages#2727mtrunkat wants to merge 5 commits into
mtrunkat wants to merge 5 commits into
Conversation
- integrating-actors-via-api.md: webhook requestUrl example uses /v2/acts/ prefix (the prefix the Console Actor-integration parser matches), not /v2/actors/. - lindy.md: fix broken rental pricing anchor to the rental page slug and note the rental model is being retired in 2026. - mastra.md: swap Actors via the tools query parameter in the MCP server URL, not a nonexistent actors parameter. - mcp-connectors/using-connectors-in-actors.md: add availability note that the connector picker is gated by a rollout and falls back to text/JSON input. - skyfire.md: minimum PAY token balance is $1, not $5 (three places); remove the Discover payment requirements section (402 discovery is x402-only, not implemented for Skyfire). - webhooks/actions.md: webhook HTTP request timeout is 2 minutes, not 30 seconds. - webhooks/index.md: HTTP POST is not the only action; note Slack, Gmail, Google Drive, and GitHub issue actions. - gumloop/index.md: Console button label is "Save as a new task", not "Create a task". - kestra.md: move input/maxItems onto the run task, fix datasetId to reference the run output, and fix the log task placement to be below get_dataset. - slack.md: attribution links to the integration settings page in Apify Console, not apify.com; list all eight ACTOR_JOB_STATUSES for runs and builds.
Contributor
|
✅ Preview for this PR (commit |
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates multiple Apify integrations docs pages to correct previously reported high/medium inaccuracies (webhooks behavior, MCP/AI connector usage, third-party integration setup details), aiming to align the documentation with current platform behavior.
Changes:
- Updates webhook docs to reflect broader available webhook actions and a 2-minute HTTP timeout, and adjusts an API webhook example URL prefix.
- Fixes/clarifies several third-party integration guides (Slack, Kestra, Gumloop) and AI/MCP docs (Skyfire, Mastra, MCP connectors in Actors, Lindy).
- Removes Skyfire content describing an unimplemented 402 “discover payment requirements” flow, and updates Skyfire minimum balance amounts.
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| sources/platform/integrations/workflows-and-notifications/slack.md | Updates Slack integration attribution description and expands the documented run/build status set. |
| sources/platform/integrations/workflows-and-notifications/kestra.md | Corrects Kestra workflow steps for fetching the default dataset from a prior Actor run. |
| sources/platform/integrations/workflows-and-notifications/gumloop/index.md | Updates the Gumloop instructions to match the current Console button label for creating tasks. |
| sources/platform/integrations/programming/webhooks/index.md | Updates webhook overview to reflect multiple action types beyond HTTP POST. |
| sources/platform/integrations/programming/webhooks/actions.md | Updates documented webhook HTTP request timeout from 30 seconds to 2 minutes. |
| sources/platform/integrations/ai/skyfire.md | Adjusts Skyfire PAY token minimums and removes an unimplemented “discover requirements” section. |
| sources/platform/integrations/ai/mcp-connectors/using-connectors-in-actors.md | Adds an availability note describing gradual rollout and fallback UI behavior for connector pickers. |
| sources/platform/integrations/ai/mastra.md | Corrects how to swap Actors when using the Apify MCP server (via the tools query parameter). |
| sources/platform/integrations/ai/lindy.md | Fixes the rental-model link target and notes rental-model retirement context. |
| sources/platform/integrations/actors/integrating-actors-via-api.md | Updates webhook requestUrl example to use the /v2/acts/ prefix for integration parsing. |
mtrunkat
commented
Jul 2, 2026
- integrating-actors-via-api.md: keep the /v2/actors/ webhook URL (per maintainer, /v2/acts/ is legacy) - using-connectors-in-actors.md: remove the MCP connector availability note (feature is fully released)
Per maintainer clarification, the API-level minimum is $1 but the MCP integration deliberately requires a $5 minimum PAY token to buffer reuse across a session. This page documents the MCP flow, so revert to $5.
mtrunkat
commented
Jul 3, 2026
- kestra.md: revert to original (keep whole file unchanged, per maintainer) - webhooks/index.md: revert to original (only HTTP POST is documented here; other actions are managed separately) - skyfire.md: restore the 'Discover payment requirements' section
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Corrects high- and medium-severity discrepancies across the integrations docs, verified against
apify-core.requestUrluses the/v2/acts/prefix (the form the Console integration parser matches); webhook request timeout is 2 minutes (not 30 seconds); webhooks index now notes actions beyond HTTP POST (Slack, Gmail, Google Drive, GitHub issue).$1(not$5); removed the "Discover payment requirements" 402 section, which is not implemented for Skyfire.toolsquery parameter (not anactorsparameter); added an availability note for MCP connectors in Actors; fixed the Lindy rental-model anchor and noted rental sunsetting.datasetIdto{{outputs.run_apify_actor.defaultDatasetId}}and fixed misplaced task properties/step references.Generated by Claude Code