docs(api): rename /v2/acts/ → /v2/actors/ in OpenAPI spec and sweep doc-site references

[mtrunkat]

Mirrors apify/apify-core#27780 on the documentation side. The server PR keeps /v2/acts/... as an undocumented alias, but the canonical, documented path family is now /v2/actors/.... This PR updates the published OpenAPI spec and the docs-site code samples accordingly.

Intentionally out of scope

• acts-get page slug references in integrate_with_apify.md and bubble.md. These URLs (e.g. https://docs.apify.com/api/v2/acts-get) are derived from the OpenAPI operationIds (acts_get, act_runs_post, etc.), which §5 of the audit covers separately. Until the operationIds are renamed, the acts-get URLs remain valid, so leaving them is correct for this PR.
• "actId": example payload in webhooks/actions.md (§12 fine-print). That's a payload field, which is §2 of the audit.
• Renaming the path YAML files themselves from paths/actors/acts@*.yaml to actors@*.yaml. The internal file names don't show up in the published spec; the $ref targets in openapi.yaml resolve them at build time. Worth a separate cleanup PR if desired.

Related

• apify/apify-core#27780 — the server-side migration (canonical routes + legacy /v2/acts/ alias).

https://claude.ai/code/session_015MYkSfTz4CsX3Y4LatpSGf

---

Generated by Claude Code

[apify-service-account]

🗑️ Preview for this PR was deleted.

[jancurn]

We should mention somewhere in the API docs that the legacy /acts paths have been deprecated, but keep working for backward compatibility. Just to have this recorded somewhere, so that it doesn't surprise or scare our users

[Copilot]

Pull request overview

Updates the Apify API documentation to use /v2/actors/... as the canonical URL prefix (replacing /v2/acts/...) across the OpenAPI spec and doc-site code samples, while documenting that /v2/acts/... remains a deprecated-but-working alias.

Changes:

• Renames Actor-scoped OpenAPI path keys from /v2/acts/... to /v2/actors/... and adds a legacy-prefix note in the spec introduction.
• Updates OpenAPI path-file inline examples (e.g., Location headers and prose path snippets) to the /v2/actors/... prefix.
• Sweeps docs-site markdown/MDX/TSX snippets to replace /v2/acts/... with /v2/actors/... in examples.

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
src/pages/api/index.tsx	Updates the API landing page hero cURL snippet to /v2/actors/.
sources/platform/integrations/programming/webhooks/ad_hoc_webhooks.md	Updates ad-hoc webhook example URL to /v2/actors/.
sources/platform/integrations/ai/x402.md	Updates example API calls to /v2/actors/ for X402 flow.
sources/platform/integrations/ai/skyfire.md	Updates synchronous run example to /v2/actors/.
sources/platform/integrations/actors/integrating_actors_via_api.md	Updates webhook requestUrl example to /v2/actors/.
sources/platform/actors/running/index.md	Updates “invoke via API” example URL to /v2/actors/.
sources/platform/actors/development/permissions/migration_guide.md	Updates API example URL to /v2/actors/.
sources/platform/actors/development/deployment/continuous_integration.md	Updates CI build endpoint examples to /v2/actors/.
sources/api/getting-started.mdx	Updates Getting started endpoints to /v2/actors/.
sources/academy/tutorials/node_js/apify_free_google_serp_api.md	Updates tutorial example URL to /v2/actors/.
sources/academy/tutorials/api/run_actor_and_retrieve_data_via_api.md	Updates tutorial API examples to /v2/actors/.
sources/academy/platform/getting_started/apify_api.md	Updates getting started examples to /v2/actors/.
sources/academy/platform/expert_scraping_with_apify/solutions/integrating_webhooks.md	Updates webhook integration examples to /v2/actors/.
apify-api/openapi/paths/actors/acts@{actorId}@versions@{versionNumber}@env-vars.yaml	Updates example URL to /v2/actors/.
apify-api/openapi/paths/actors/acts@{actorId}@versions.yaml	Updates example URL to /v2/actors/.
apify-api/openapi/paths/actors/acts@{actorId}@runs@last.yaml	Updates prose path snippet to /v2/actors/.
apify-api/openapi/paths/actors/acts@{actorId}@runs.yaml	Updates Location example to /v2/actors/.
apify-api/openapi/paths/actors/acts@{actorId}@builds.yaml	Updates Location example to /v2/actors/.
apify-api/openapi/paths/actors/acts.yaml	Updates example URL to /v2/actors/.
apify-api/openapi/openapi.yaml	Renames Actor path keys to /v2/actors/ and documents the legacy /v2/acts/ prefix.

[tobice]

The server PR keeps /v2/acts/... as an undocumented alias, but the canonical, documented path family is now /v2/actors/....

I guess we'll have to update the middleware that ensures that the spec is up to date, right? Because the specification for the legacy paths will be missing there and the middleware needs to be able to detect it.

--

Anyway, this looks like basically s/acts/actors/ for all paths 😄 Just like in the other PR, not sure if the PR description length is really justified here...

But there are plenty of reviewers here -> approve.