Skip to content

docs(wix-manage): document source_url on Site Import's StartImport - #852

Open
itayhewix wants to merge 4 commits into
mainfrom
docs/dev3-site-import-source-url
Open

docs(wix-manage): document source_url on Site Import's StartImport#852
itayhewix wants to merge 4 commits into
mainfrom
docs/dev3-site-import-source-url

Conversation

@itayhewix

@itayhewix itayhewix commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Summary

  • StartImportRequest has an optional source_url field alongside request, confirmed against the SiteImportService proto (wix-private/replatform-sb). It's the actual identity key the service uses to select which migration a Start call joins — not just a convenience hint.
  • StartImportRequest also gained fileUrls (spec 0019): setting it starts a FILE run that imports CSV/TSV export URLs directly, with no source-site probe and no source credentials requested. When source_url is absent, the file set itself becomes the migration identity. Reports back sourcePlatform: CSV; an unreachable URL rejects the whole call with INVALID_FILE_URL.
  • Updated the site-import skill's frontmatter description, Start examples, endpoint docs, dedup rule, and error rules to cover both fields.
  • Checked the two site-import eval YAMLs (sites/site-import-start.yml, sites/site-import-status-handling.yml) — neither asserts on the Start request body shape, so no eval changes needed.

Test plan

  • Reviewed proto source for StartImportRequest (including fileUrls) to confirm field names, optionality, and semantics
  • Confirmed eval YAMLs don't need updates

🤖 Generated with Claude Code

itayhewix and others added 4 commits August 5, 2026 15:48
StartImportRequest now has an optional source_url field alongside request
(confirmed against the SiteImportService proto) that is the actual identity
key selecting which migration a request joins, not just a convenience hint.
Update the skill's Start examples and the one-import-per-store dedup rule
to match, and add the SITE_UNIDENTIFIED error case.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
StartImportRequest also gained fileUrls (spec 0019) alongside source_url:
setting it starts a FILE run that imports CSV/TSV exports directly with no
source-site probe or credentials. When source_url is absent, the file set
itself becomes the migration identity. Document the field, its INVALID_FILE_URL
error, and the new CSV SourcePlatform value FILE runs report back.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Covers the new fileUrls field: importing from a CSV/TSV export URl with no
source site, no source credentials, and the file-set-as-identity rule when
source_url is absent.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
… description

The Start body template's blanket "MUST include the source store URL" for
request contradicted the file-only run flow, where there is no source
store URL; scope it to the crawl case and cover the file-only path in
"Before starting an import". Also clarify that a combined source_url +
fileUrls call is still a FILE run (source_url only changes identity
keying, it doesn't add a crawl).

The new eval's description claimed to test the source_url identity rule
"when a site is also named", but its triggerPrompt has no source site at
all — trimmed the description to match what the prompt actually exercises.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant