Entity Bulk Seed

Seed the knowledge graph with a batch of customer-authored canonical entities in one request — their types, descriptions, synonyms, and per-entity attributes.

• POST /v3/entities/bulk creates or merges each entity into a single bucket (the optional bucket reference, else the account+environment default). For each row the entity's type is resolved or created in your taxonomy, the entity is upserted on its normalized canonical, and any synonyms are attached as customer_defined. An entity that already exists is merged (onConflict: "merge"): synonyms are added additively, a longer description replaces the old one, and attributes are merged with new keys winning.
• Small batches (fewer than 100 entities) process synchronously and return 200 with a per-row results array and a summary.
• Larger batches process asynchronously: the call returns 202 with a seedJobID and a statusURL. Poll GET /v3/entities/seed/{id} until status is completed (or failed); the completed response includes the per-row results.

Each row's outcome is one of created, merged-with, or rejected (with a reason, e.g. an attribute key not declared in the type's schema).