netlify deploy fails with misleading "Project not found" when extensions fetch returns 403 under send_build_bot_token_to_jigsaw (non-Owner / PAT)
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 20/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- typescript
- 領域
- cli
調査の方向性
The failure starts in the extensions fetch against api.netlifysdk.com, which sends the PAT as Netlify-SDK-Build-Bot-Token when the site has send_build_bot_token_to_jigsaw set. Reproduce the two curl calls in the report to confirm the 200 and 403 split, then find where @netlify/config handles that 403 and where the offline fallback produces "Project not found". Done means a non-Owner static deploy succeeds, or the extensions 403 is reported as a permissions problem instead of the link error.
索引モデルが issue の本文から書いたものです。
説明
Describe the bug
On an Enterprise team (Okta/SSO), netlify deploy --site <site_id> --dir … --prod --no-build fails even though the site ID is valid and the auth token can successfully GET /api/v1/sites/:id.
With site feature flag send_build_bot_token_to_jigsaw: true, @netlify/config sends the user PAT as Netlify-SDK-Build-Bot-Token to Jigsaw. That call returns 403. The CLI then falls back to offline config resolution and reports:
Error: Project not found. Please rerun "netlify link"
That error is misleading: the project exists and is addressable; linking is not the problem.
Isolated comparison against the same extensions URL
(https://api.netlifysdk.com/team/<account_id>/integrations/installations/meta/<site_id>):
- Headers
Netlify-Config-Mode: cli+ User-Agent only → 200 [] - Same +
Netlify-SDK-Build-Bot-Token: <PAT>→ 403
Per Netlify roles docs, only Owner can install/uninstall extensions. A Developer (or other non-Owner) can still need to deploy a prebuilt static site. Making extensions fetch hard-fail blocks those deploys and hides the real cause.
Expected: static --dir / --no-build deploy should succeed (or soft-fail extensions to []), and errors should report the extensions 403 / permissions issue—not “Project not found / netlify link”.
Workaround: upload via Sites API zip deploy (POST /api/v1/sites/:id/deploys with Content-Type: application/zip), which does not call Jigsaw.
Steps to reproduce
- Use a site with
send_build_bot_token_to_jigsaw: true(GET /api/v1/sites/:id?feature_flags=cli). - Authenticate as a non-Owner (e.g. Developer) with a PAT that has SAML team access and can read the site.
- Build a static site into
dist/(no Netlify Functions/extensions required). - Run:
npx [email protected] deploy \
--dir=dist \
--prod \
--no-build \
--debug \
--site=<site_uuid>
- Observe debug warnings about extensions 403, then offline fallback, then:
Error: Project not found. Please rerun "netlify link"
- Optionally confirm with curl:
# 200 without build-bot token
curl -sS -o /dev/null -w "%{http_code}\n" \
-H "Netlify-Config-Mode: cli" \
-H "User-Agent: Netlify Config (mode:cli) / 25.2.6" \
"https://api.netlifysdk.com/team/<account_id>/integrations/installations/meta/<site_id>"
# 403 with PAT as build-bot token
curl -sS -o /dev/null -w "%{http_code}\n" \
-H "Netlify-Config-Mode: cli" \
-H "User-Agent: Netlify Config (mode:cli) / 25.2.6" \
-H "Netlify-SDK-Build-Bot-Token: $NETLIFY_AUTH_TOKEN" \
"https://api.netlifysdk.com/team/<account_id>/integrations/installations/meta/<site_id>"
Configuration
There is no netlify.toml for this project. Deploy is a prebuilt static upload only (--dir=dist --prod --no-build --site=<uuid>). No Netlify Functions, Edge Functions, or Extensions are configured for the site.
Relevant site feature flags (excerpt from GET /api/v1/sites/:id?feature_flags=cli):
{
"send_build_bot_token_to_jigsaw": true,
"cli_fetch_integrations": true,
"auto_install_required_extensions_v2": true
}
Environment
System:
OS: macOS 26.6.2
CPU: (11) arm64 Apple M3 Pro
Memory: 97.36 MB / 18.00 GB
Shell: 5.9 - /bin/zsh
Binaries:
Node: 24.18.0 - ~/node/24.18.0/bin/node
npm: 11.10.1 - ~/npm/11.10.1/bin/npm
- 主要言語
- TypeScript
- スター
- 1.9k
- フォーク
- 480
- 平均マージ
- 1日 15時間
- マージ済み PR（30日）
- 66
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
netlify/cli のほかの issue
-
db-status.test fails if the database is disabled対応中かも @paulleephp が 2 日前に担当しました。 オープンtype: bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
`client-ip` is not an IP address when `x-forwarded-for` holds a list or a port対応中かも @Dev-next-gen が 23 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
`netlify dev` with `--cwd` from outside the project: every function 500s with "module is not defined in ES module scope" (`detectZisiBuilder` passes a string to `readPackageUp`)対応中かも @bsplatt92 が 63 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信
-
area: command: deploy area: docs type: feature
難易度 1/5 1時間未満 初心者へのやさしさ 88/100
netlify/cli#1984 · コメント 19 件 · リアクション 3 件 ·
メンテナーはふだん 1 日以内に返信
-
type: bug
難易度 3/5 1〜2日 初心者へのやさしさ 38/100
メンテナーはふだん 1 日以内に返信
似ている issue
-
engine-rs P3 review-deferral wasm
難易度 2/5 1〜3時間 初心者へのやさしさ 77/100
maniator/verticopolis#1154 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
メンテナーはふだん 1 日以内に返信
-
Bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
telerik/kendo-react#3861 ·
メンテナーはふだん 1 日以内に返信
-
[bug]: use-mobile.ts uses pixel logic, causing UI state de-sync with Tailwind CSS rem breakpointsオープンbug
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
task
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100