Cognite Data Fusion API

Retrieve Mappings

Retrieve a list of up to 100 mappings by their external ID, optionally ignoring unknown IDs.

Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code

Request

header Parameters

cdf-version

string (Cdf-Version)

Request Body schema: application/json
required

List of external IDs of mappings to retrieve.

required	Array of objects (Items) [ 1 .. 100 ] items
ignoreUnknownIds	boolean (IgnoreUnknownIds) Ignore IDs and external IDs that are not found

Responses

200

List of retrieved mappings.

400

The response for a bad request.

422

Validation Error

post/writeback/sap/mappings/byids

Request samples

Payload
curl

application/json

{"items": [{"externalId": "my.known.id"
}
],
"ignoreUnknownIds": true
}

Response samples

application/json

{"items": [{"externalId": "my.known.id",
"mapping": {"expression": "string"
},
"input": {"type": "protobuf",
"messageName": "string",
"files": [{"fileName": "string"
}
]
},
"published": true,
"createdTime": 1730204346000,
"lastUpdatedTime": 1730204346000
}
]
}

➔ Next to Writeback Requests

Retrieve Mappings

header Parameters

Request Body schema: application/jsonrequired

Request Body schema: application/json
required