Skip to main content
POST
Merge entities in bulk from a spreadsheet

Headers

x-project-id
string
required

Project ID to specify the project context

Body

application/json
edges
object[]
required

Every merge edge in the file, in one request. Chains and cycles are resolved across the whole set.

Example:
dryRun
boolean

Report what would happen without merging anything.

Example:

true

Response

dryRun
boolean
required

True when nothing was written.

Example:

false

merged
number
required

Entities merged away.

Example:

42

unchanged
number
required

Edges that were already satisfied.

Example:

3

failed
number
required

Edges rejected.

Example:

1

survivors
number
required

Distinct survivors this batch resolved to, the number of merge operations performed.

Example:

7

results
object[]
required

One entry per submitted edge, in submission order.