[thedogwiththedataonit]

Adds contacts.import for named JSON batches and aligns CSV imports with the shared Import History response from app #2194. Both return importId and required summary.total = inserted + updated + failed + skipped. Errors and warnings accept optional positive, 1-based row positions. CSV skip warnings identify the first 100 skipped rows, then summarize any remainder without a row index. Completed validation and persistence outcomes are preserved.

Refreshed against SDK main 5fc74b7254070387a603df89e1799829a3c4bfbe, preserving merged category/group #78 and SDK 13 features. Canonical generation from app source e87215e3c09418b1c43300b4f343b290a28a8f94 corrects the CSV validate description: at most 100 submitted data rows use inline submitted-row charges; larger imports use background charges per address and return a job ID only when queued. No fields or runtime behavior changed. App and all three consumer YAML files match byte-for-byte: raw SHA-256 89f71c3eaaee5ed17ce090d0488815d41250a86c13a357cf10d3b14d46f9a763. Generated SDK types include that description. Version 13.0.0 and its published changelog remain unchanged; additions remain under Unreleased.

The resource guide now covers JSON imports, CSV batch names, totals, row details and bounded skip warnings. Guide and JSDoc clarify the 100-submitted-contact/CSV-row inline cutoff, inline submitted-row charges, background charges per address, and validation counts or a job ID only when checks run or work is queued. Deleting an import preserves contacts subsequently updated by another import.

Validation: six final API parity tests, TypeScript, ESLint, generated-type checks, owner openapi:check:all and diff checks pass. The 26 focused import/validation/template tests passed before this description-only update; runtime and field shapes are unchanged. Strict compilation of all three guide examples and formatting pass. No live API calls, imports or package publications were performed.

Keep this draft through app #2194's strict cache/cost evaluation and signed-in acceptance gates, then its merge and API deployment. Release this SDK next. CLI #65 validates against reviewed immutable source and must replace its temporary Git pin with the actual published SDK artifact and regenerate its lockfile before CLI release. Publish docs #326 after its API/SDK/CLI examples are available.

Final app owner #2194 head c2ed746b3558f2a849f4410fa21228646563b0d8 contains these same contract descriptions and artifacts. Owner OpenAPI, contract-audit and generated-reference freshness checks pass against the refreshed consumers.

Confidence Score: 5/5

The reviewed changes appear safe to merge, subject to the stated API deployment and release gates.

Summary

Adds contacts.import for named JSON batches and shares the response shape with CSV imports.

• JSON contact batches can be sent as one named import.
• JSON and CSV imports return the same batch details.
• Validation results distinguish completed checks from provider outages.

_{Reviews (12) · Last reviewed commit: "Merge remote-tracking branch 'origin/mai..." · Reviewed by Greptile}

[thedogwiththedataonit]

Re the changelog note on contacts.validate (Greptile P2): added under Unreleased → Changed with a narrowing example (07b8a6f); ContactValidationResult JSDoc describes the checkOutcome union.