IndexNow URL Submission

Role and auth requirements

• Primary roles: OWNER, OPERATOR
• Auth mode: JWT (Authorization: Bearer <token>)

UI flow (draft)

1. Select target handle and hostname.
2. Paste URL list.
3. Submit and track submission result.

API fallback (draft)

• POST /v2/handles/{handle}/site-intel/{hostname}/submit-urls

Input validation rules

• Body must be a JSON object.
• urls is required and must contain 1-100 entries.
• Optional providers must be any of google, bing, yandex, naver.

Failure and remediation (draft)

• 400 invalid_json: request body is missing, malformed, or not a JSON object.
• 400 urls_required: provide at least one URL.
• 400 too_many_urls: split request into batches of 100 URLs max.
• 400 invalid_providers: pass only supported provider names.
• 401 unauthorized: refresh token and retry.
• 429 rate_limited: split into smaller batches and retry.
• 503 unavailable: retry once provider dependency is healthy.