Skip to content

Compile a field mapping version.

Deprecated
POST
/api/admin/field-mapping/field-mapping-sets/{fieldMappingSetId}/versions/{fieldMappingVersionId}/compile
Code sample: Shell / cURL
curl --request POST \
--url https://auth.example.com/api/admin/field-mapping/field-mapping-sets/example/versions/example/compile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "catalogVersionId": "catalog_version_123", "compatibilityRange": ">=1.0.0" }'

Compiles a field mapping version against a catalog version and returns the compiled snapshot metadata. For a set the platform owns, the catalog version must be the platform’s, every source must be a field of it, and a custom field is refused. Deprecated: this is one of the five steps (set, version, publish, compile, activate) that POST /api/admin/identity-mapping/sets and PUT /api/admin/identity-mapping/sets/{id} run in one call, with the same checks and a release safety check made when the content is saved. It keeps working unchanged; new clients use the Mapping Set facade.

fieldMappingSetId
required
string

Field mapping set identifier.

fieldMappingVersionId
required
string

Field mapping version identifier.

Idempotency-Key
string

Idempotency key for state-changing operations that support replay protection.

Media type application/json
object
catalogVersionId
required
string
compatibilityRange
string
artifactRef
string
metadata
object
key
additional properties
key
additional properties
Example
{
"catalogVersionId": "catalog_version_123",
"compatibilityRange": ">=1.0.0"
}

Field mapping compile response.

Media type application/json
object
result
required
object
id
required
string
tenantId
required
string
fieldMappingVersionId
required
string
catalogVersionId
required
string
snapshotHash
required
string
dependencyGraphId
required
string
lifecycleState
required
string
key
additional properties
key
additional properties
Example generated
{
"result": {
"id": "example",
"tenantId": "example",
"fieldMappingVersionId": "example",
"catalogVersionId": "example",
"snapshotHash": "example",
"dependencyGraphId": "example",
"lifecycleState": "example"
}
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
"error": "example",
"message": "example",
"error_description": "example"
}