Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: taskade/docs
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: main
Choose a base ref
...
head repository: taskade/docs
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: docs/developer-platform-accuracy
Choose a head ref
Checking mergeability… Don’t worry, you can still create the pull request.
  • 2 commits
  • 15 files changed
  • 1 contributor

Commits on Jun 5, 2026

  1. docs: developer platform accuracy — v1/v2 APIs, MCP, SDK, auth + deve… 

    …loper-first nav

Corrects the public developer surface across the API docs and refocuses
navigation around developers and product structure. Every API operation,
auth flow, MCP surface, and SDK claim verified against the taskcade
codebase + live OpenAPI specs (/api/documentation/v1, /api/documentation/v2).

Key corrections (the five fictions removed):
- Action API v2 reframed as action/RPC (POST /{operation}), beta — not REST;
  honest v1-vs-v2 capability matrix; v2 tasks documented as read-only.
- MCP corrected to the real surfaces: local @taskade/mcp-server (public npm),
  hosted www.taskade.com/mcp (OAuth2+PKCE, mcp scope, type:http,
  list_spaces/inspect_space/write_file only) — no invented tools.
- @taskade/sdk marked Preview / not-on-public-npm; recipes rewritten HTTP-first
  off real v2 operations (no fabricated Taskade facade / TaskadeAPIError).
- Auth: PAT tskdp_ at /settings/api, OAuth2 Authorization Code + PKCE, /oauth2/*.
- Webhooks: no subscription endpoint — events via automation triggers.

Nav: developer-first SUMMARY (Platform + APIs & Developer promoted), surfaced
orphan pages (workspace-dna, mcp-connectors, agent-teams); preserves GitBook's
nested changelog-2026 timeline + github-import-export/genesis-auth/credits-and-billing.

All internal links verified resolving (192/193 SUMMARY links; 1 external).
    @johnxie
    johnxie committed Jun 5, 2026
    Configuration menu
    Copy the full SHA
    daa6707 View commit details
    Browse the repository at this point in the history

  2. review fixes: SUMMARY dedup + re-register developer overview, MCP nam… 

    …ing, SDK response shape

Addresses pre-merge code-review findings (>=80 confidence):
- SUMMARY.md: removed duplicate MCP Connectors nav entry (was listed under both
  APIs & Developer and Taskade Genesis); re-registered developers/README.md
  (Developer Overview) which was modified but orphaned from nav.
- workspace-mcp-advanced.md: renamed outbound surface 'Hosted MCP v2' ->
  'MCP Connectors' (3x) to stop conflating it with the inbound Hosted MCP server.
- sdk-quickstart.md: clarified promptAgent response body is { ok, summary }.
    @johnxie
    johnxie committed Jun 5, 2026
    Configuration menu
    Copy the full SHA
    a6dcfba View commit details
    Browse the repository at this point in the history
Loading