Sign in

v1

latestOpenAPI 3.1.0Serval License2026-07-26202952779.1 KB
Entity Field Mapping API

Create Entity Field Mapping

Create a field mapping binding an external source field (from an ingestion config's discovered external schema) to an internal entity-type field. Takes effect on the next sync of the ingestion config.

post/v2/entity-field-mappings

Request body

ingestionConfigIdstring

The ingestion config that provides the source data (required). The mapping binds to this config's most recently discovered external schema; a sync must have run first (otherwise NOT_FOUND).

internalFieldIdstring

The internal entity-type field to populate (required).

externalFieldPathstring

Dot-notation path into the external record, e.g. "general.platform" (required). Read the available paths via GetExternalEntitySchema.

prioritynumber double nullable

Precedence when multiple sources map to the same internal field (higher wins). Defaults to 1.0.

Response

Success