@epilot/sdk 2.20.24 → 2.20.25

package/definitions/entity-mapping.json

@@ -1,1852 +0,0 @@
-{
-  "openapi": "3.0.3",
-  "info": {
-    "title": "Entity Mapping API",
-    "description": "API Backend for mapping source entity into target entities",
-    "version": "1.0.0"
-  },
-  "tags": [
-    {
-      "name": "mappings",
-      "description": "Entity Mapping Configs"
-    }
-  ],
-  "security": [
-    {
-      "EpilotAuth": []
-    }
-  ],
-  "paths": {
-    "/v1/mappings": {
-      "post": {
-        "operationId": "storeConfig",
-        "summary": "storeConfig",
-        "description": "Store new MappingConfig",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "name": "with_id",
-            "in": "query",
-            "required": false,
-            "description": "Whether ids are part of the body or not",
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "description": "Mapping Config to store",
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/MappingConfig"
-              }
-            }
-          }
-        },
-        "responses": {
-          "201": {
-            "description": "The updated entity mapping config",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfig"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/mappings/{id}": {
-      "get": {
-        "operationId": "getConfig",
-        "summary": "getConfig",
-        "description": "Get latest version of a mapping config by id",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "description": "Mapping Config Id",
-            "schema": {
-              "type": "string",
-              "example": "70542580-2b38-4bfc-af8d-bb90102f9f47"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Entity Mapping Config",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfig"
-                }
-              }
-            }
-          }
-        }
-      },
-      "delete": {
-        "operationId": "deleteConfig",
-        "summary": "deleteConfig",
-        "description": "Delete entity mapping config",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "description": "Mapping Config Id",
-            "schema": {
-              "type": "string",
-              "example": "70542580-2b38-4bfc-af8d-bb90102f9f47"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "The deleted mapping config",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfig"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/mappings/{id}/versions": {
-      "get": {
-        "operationId": "getAllVersions",
-        "summary": "getAllVersions",
-        "description": "Get all version of MappingConfig",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "description": "Mapping Config Id",
-            "schema": {
-              "type": "string",
-              "example": "70542580-2b38-4bfc-af8d-bb90102f9f47"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "All versions of a MappingConfig",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfigsResp"
-                }
-              }
-            }
-          }
-        }
-      },
-      "post": {
-        "operationId": "storeNewVersion",
-        "summary": "storeNewVersion",
-        "description": "Store new version of MappingConfig",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "description": "Mapping Config Id",
-            "schema": {
-              "type": "string",
-              "example": "70542580-2b38-4bfc-af8d-bb90102f9f47"
-            }
-          }
-        ],
-        "requestBody": {
-          "description": "Mapping Config to store",
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/MappingConfig"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "The updated entity mapping config",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfig"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/mappings/{id}/versions/{version}": {
-      "get": {
-        "operationId": "getConfigVersion",
-        "summary": "getConfigVersion",
-        "description": "Get specific version of a mapping config by id & version",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "description": "Mapping Config Id",
-            "schema": {
-              "type": "string",
-              "example": "70542580-2b38-4bfc-af8d-bb90102f9f47"
-            }
-          },
-          {
-            "name": "version",
-            "in": "path",
-            "required": true,
-            "description": "Version to be loaded",
-            "schema": {
-              "type": "number",
-              "example": 3
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Entity Mapping Config",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfig"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/mappings:execute": {
-      "post": {
-        "operationId": "executeMapping",
-        "summary": "executeMapping",
-        "description": "Execute entity mapping based on a config",
-        "parameters": [
-          {
-            "name": "preview_mode",
-            "in": "query",
-            "required": false,
-            "description": "True, if you want to preview the entities which will result",
-            "schema": {
-              "type": "boolean",
-              "example": true
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ExecuteMappingReq"
-              }
-            }
-          }
-        },
-        "tags": [
-          "mappings"
-        ],
-        "responses": {
-          "200": {
-            "description": "The target entities which were mapped",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ExecuteMappingResp"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/mappings:search": {
-      "post": {
-        "operationId": "searchConfigs",
-        "summary": "searchConfigs",
-        "description": "Search mapping configs",
-        "tags": [
-          "mappings"
-        ],
-        "requestBody": {
-          "description": "Search Mapping Configs",
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/SearchMappingReq"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "Entity Mapping Config",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfig"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/mappings/history": {
-      "get": {
-        "operationId": "queryMappingHistory",
-        "summary": "queryMappingHistory",
-        "description": "Get the Mapping History",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "in": "query",
-            "name": "from",
-            "schema": {
-              "type": "string",
-              "format": "datetime"
-            },
-            "required": false,
-            "description": "filter the history from this date on"
-          },
-          {
-            "in": "query",
-            "name": "to",
-            "schema": {
-              "type": "string",
-              "format": "datetime"
-            },
-            "required": false,
-            "description": "filter the history to this date on"
-          },
-          {
-            "in": "query",
-            "name": "targetEntityId",
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "in": "query",
-            "name": "sourceEntityId",
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Query result of mapping history",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "properties": {
-                    "results": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/components/schemas/MappingHistoryResp"
-                      }
-                    }
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/relations:execute": {
-      "post": {
-        "operationId": "executeRelations",
-        "summary": "executeRelations",
-        "description": "Execute relation mapping between source entity and target entities",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ExecuteRelationsReq"
-              }
-            }
-          }
-        },
-        "tags": [
-          "mappings"
-        ],
-        "responses": {
-          "200": {
-            "description": "The relations which were for both source entity and main entity",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ExecuteRelationsResp"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v2/mappings/{id}": {
-      "get": {
-        "operationId": "getMappingConfig",
-        "summary": "getMappingConfig",
-        "description": "Get latest version of a mapping config by id V2",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "description": "Mapping Config Id",
-            "schema": {
-              "type": "string",
-              "example": "70542580-2b38-4bfc-af8d-bb90102f9f47"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Entity Mapping Config",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfigV2"
-                }
-              }
-            }
-          }
-        }
-      },
-      "put": {
-        "operationId": "putMappingConfig",
-        "summary": "putMappingConfig",
-        "description": "Stores new version of entity mapping config",
-        "tags": [
-          "mappings"
-        ],
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "description": "Mapping Config Id",
-            "schema": {
-              "type": "string",
-              "example": "70542580-2b38-4bfc-af8d-bb90102f9f47"
-            }
-          }
-        ],
-        "requestBody": {
-          "description": "Mapping Config to store",
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/MappingConfigV2"
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "The updated entity mapping config",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/MappingConfigV2"
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  },
-  "components": {
-    "securitySchemes": {
-      "EpilotAuth": {
-        "type": "http",
-        "scheme": "bearer",
-        "description": "Epilot Bearer Token"
-      }
-    },
-    "schemas": {
-      "SearchMappingReq": {
-        "type": "object",
-        "properties": {
-          "source": {
-            "$ref": "#/components/schemas/SourceConfig"
-          }
-        }
-      },
-      "MappingConfigsResp": {
-        "type": "object",
-        "properties": {
-          "configs": {
-            "$ref": "#/components/schemas/MappingConfigs"
-          }
-        },
-        "required": [
-          "configs"
-        ]
-      },
-      "MappingConfigs": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/MappingConfig"
-        }
-      },
-      "MappingConfig": {
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/MappingConfigCommonFields"
-          },
-          {
-            "type": "object",
-            "properties": {
-              "org_id": {
-                "type": "string",
-                "example": "66"
-              },
-              "version": {
-                "type": "integer",
-                "example": 2
-              }
-            }
-          }
-        ],
-        "required": [
-          "org_id",
-          "version"
-        ]
-      },
-      "MappingConfigV2": {
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/MappingConfigCommonFields"
-          },
-          {
-            "type": "object",
-            "properties": {
-              "org_id": {
-                "type": "string",
-                "example": "66",
-                "readOnly": true
-              },
-              "version": {
-                "type": "integer",
-                "example": 2,
-                "readOnly": true
-              }
-            }
-          }
-        ]
-      },
-      "MappingConfigCommonFields": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string"
-          },
-          "source": {
-            "$ref": "#/components/schemas/SourceConfig"
-          },
-          "targets": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/TargetConfig"
-            }
-          },
-          "created_at": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "updated_at": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "created_by": {
-            "$ref": "#/components/schemas/Owner",
-            "description": "User / service who created the entity mapping config",
-            "example": {
-              "type": "internal_service"
-            }
-          },
-          "last_updated_by": {
-            "$ref": "#/components/schemas/Owner",
-            "description": "User / service who last updated entity mapping config",
-            "example": {
-              "type": "user",
-              "org_id": 255151,
-              "user_id": 99252
-            }
-          }
-        },
-        "required": [
-          "id",
-          "source",
-          "targets"
-        ]
-      },
-      "Owner": {
-        "type": "object",
-        "properties": {
-          "type": {
-            "type": "string",
-            "enum": [
-              "user",
-              "internal_service"
-            ]
-          },
-          "org_id": {
-            "type": "string"
-          },
-          "user_id": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "type"
-        ]
-      },
-      "ExecuteRelationsReq": {
-        "type": "object",
-        "description": "Build relations between a source entity and one or more target entities, dynamically identified",
-        "properties": {
-          "source_ref": {
-            "$ref": "#/components/schemas/EntityRef",
-            "description": "Entity for which to add relations."
-          },
-          "target": {
-            "type": "object",
-            "properties": {
-              "main_entity_ref": {
-                "$ref": "#/components/schemas/EntityRef",
-                "description": "Main Entity from where to locate target entities. Eg. submisssion entity"
-              },
-              "relation_attributes": {
-                "type": "array",
-                "description": "Relation mappings",
-                "items": {
-                  "$ref": "#/components/schemas/RelationAttribute"
-                }
-              },
-              "linkback": {
-                "type": "object",
-                "description": "For cases where you want to store a relation between main entity (eg. submission) and current source entity.",
-                "properties": {
-                  "attribute": {
-                    "type": "string",
-                    "default": "mapped_entities",
-                    "description": "Relation attribute on the main entity (submission) where the target entity will be linked. Set to false to disable linkback\n"
-                  },
-                  "relation_tags": {
-                    "type": "array",
-                    "description": "Relation tags (labels) to include in main entity linkback relation attribute",
-                    "items": {
-                      "type": "string"
-                    }
-                  }
-                },
-                "required": [
-                  "attribute",
-                  "relation_tags"
-                ]
-              }
-            },
-            "required": [
-              "main_entity_ref",
-              "relation_attributes"
-            ]
-          },
-          "additional_relations": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/RelationItem"
-            }
-          }
-        },
-        "required": [
-          "source_ref"
-        ]
-      },
-      "ExecuteRelationsResp": {
-        "type": "object",
-        "properties": {
-          "relations": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/NewRelationItem"
-            }
-          }
-        }
-      },
-      "NewRelationItem": {
-        "type": "object",
-        "properties": {
-          "source_entity_id": {
-            "type": "string"
-          },
-          "target_entity_id": {
-            "type": "string"
-          },
-          "relation_attr": {
-            "type": "string"
-          },
-          "tags": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          }
-        },
-        "required": [
-          "source_entity_id",
-          "target_entity_id",
-          "relation_attr"
-        ]
-      },
-      "RelationItem": {
-        "type": "object",
-        "properties": {
-          "entity_id": {
-            "type": "string"
-          },
-          "attribute": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "entity_id",
-          "attribute"
-        ]
-      },
-      "ExecuteMappingReq": {
-        "type": "object",
-        "description": "Pass either source or source_entity",
-        "properties": {
-          "source_ref": {
-            "$ref": "#/components/schemas/EntityRef",
-            "description": "A reference (id and schema) to the entity to be used as source."
-          },
-          "loop_ref": {
-            "$ref": "#/components/schemas/EntityRef",
-            "description": "Reference to the current iteration's entity when running inside a flow loop.\nWhen set, its fields and relations are merged into the source context;\non schema conflicts the loop entity wins, so paths like `<schema>._id` resolve\nto the iteration entity rather than to a same-schema relation of the source.\n"
-          },
-          "targets": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/TargetConfig"
-            },
-            "description": "Mapping Configuration to apply."
-          }
-        },
-        "required": [
-          "source_ref",
-          "targets"
-        ]
-      },
-      "ExecuteMappingResp": {
-        "type": "object",
-        "properties": {
-          "mapped_entities": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Entity"
-            }
-          },
-          "failures": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/MappingFailure"
-            }
-          },
-          "warnings": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/MappingWarning"
-            }
-          }
-        },
-        "required": [
-          "mapped_entities"
-        ]
-      },
-      "MappingFailure": {
-        "type": "object",
-        "properties": {
-          "target": {
-            "$ref": "#/components/schemas/TargetConfig"
-          },
-          "error": {
-            "type": "object",
-            "properties": {
-              "isSilent": {
-                "type": "boolean"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "additionalProperties": true
-          }
-        }
-      },
-      "MappingWarning": {
-        "type": "object",
-        "properties": {
-          "explanation": {
-            "type": "string"
-          },
-          "context": {
-            "type": "string"
-          },
-          "id": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "explanation"
-        ]
-      },
-      "Entity": {
-        "type": "object",
-        "properties": {
-          "_id": {
-            "type": "string"
-          },
-          "_schema": {
-            "type": "string"
-          },
-          "_title": {
-            "type": "string",
-            "nullable": true
-          },
-          "_org": {
-            "type": "string"
-          },
-          "_tags": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "nullable": true
-          },
-          "_created_at": {
-            "type": "string",
-            "nullable": true
-          },
-          "_updated_at": {
-            "type": "string",
-            "nullable": true
-          },
-          "required": [
-            "_id",
-            "_schema",
-            "_org",
-            "_created_at",
-            "_updated_at"
-          ]
-        },
-        "additionalProperties": true
-      },
-      "EntityRef": {
-        "type": "object",
-        "properties": {
-          "entity_id": {
-            "type": "string",
-            "description": "id of the source entity to be mapped"
-          },
-          "entity_schema": {
-            "description": "schema of the source entity",
-            "type": "string",
-            "example": "submission"
-          }
-        },
-        "required": [
-          "entity_id"
-        ]
-      },
-      "SourceConfig": {
-        "type": "object",
-        "properties": {
-          "type": {
-            "type": "string",
-            "enum": [
-              "journey",
-              "entity"
-            ]
-          },
-          "config": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/JourneyRef"
-              },
-              {
-                "$ref": "#/components/schemas/EntityRef"
-              }
-            ]
-          }
-        }
-      },
-      "JourneyRef": {
-        "type": "object",
-        "properties": {
-          "journey_id": {
-            "type": "string"
-          }
-        }
-      },
-      "Loop_Index_String": {
-        "type": "string",
-        "description": "This string value will be replaced with the value of the loop index, when mapping in loop mode",
-        "enum": [
-          "##LOOP_INDEX##"
-        ]
-      },
-      "TargetConfig": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "description": "Identifier for target configuration. Useful for later usages when trying to identify which target config to map to."
-          },
-          "name": {
-            "type": "string",
-            "description": "A name for this configuration"
-          },
-          "allow_failure": {
-            "type": "boolean",
-            "description": "Pass it as true, when you don't want failures to interrupt the mapping process."
-          },
-          "target_schema": {
-            "type": "string",
-            "description": "Schema of target entity"
-          },
-          "target_unique": {
-            "type": "array",
-            "description": "Unique key for target entity (see upsertEntity of Entity API)",
-            "items": {
-              "type": "string"
-            }
-          },
-          "use_uniqueness_criteria": {
-            "type": "boolean",
-            "default": false,
-            "description": "Execution wire flag set per automation by automation-workers: resolve the target entity via the organization's global uniqueness criteria (deduplication-api) instead of target_unique. Never persisted in stored mapping configs.\n"
-          },
-          "loop_config": {
-            "type": "object",
-            "description": "contains config in case of running in loop mode",
-            "properties": {
-              "source_path": {
-                "type": "string",
-                "description": "path to the array from the entity payload"
-              },
-              "source_type": {
-                "type": "string",
-                "description": "Kind of journey block the loop iterates. 'journey-multi-select' (default) is a cards block with multi selection. 'journey-file-upload' is a file upload block: source_path points at the submission's `_files.$relation` array and `filter_tags` narrows it down to the block's files. Forwarded to the flow-level loop by the Automation Hub.\n",
-                "enum": [
-                  "journey-multi-select",
-                  "journey-file-upload"
-                ],
-                "default": "journey-multi-select"
-              },
-              "filter_tags": {
-                "type": "array",
-                "description": "Only iterate items of the array whose `_tags` contain every listed tag. Meant for relation arrays such as `submission._files.$relation`, where the journey tags each file relation with the upload block it came from. `##LOOP_INDEX##` keeps referring to the item's index in the unfiltered array.\n",
-                "items": {
-                  "type": "string"
-                },
-                "example": [
-                  "_hidden_ 2a4b1c3d-0000-4000-8000-000000000000 - Dokumente"
-                ]
-              },
-              "length": {
-                "type": "number",
-                "description": "a hard limit of how many times the loop is allowed to run."
-              }
-            }
-          },
-          "conditionMode": {
-            "description": "Mode of how conditions are considered valid",
-            "type": "string",
-            "enum": [
-              "oneOf",
-              "anyOf",
-              "allOf"
-            ]
-          },
-          "conditions": {
-            "type": "array",
-            "description": "Conditions necessary to hold for the target entity to be mapped",
-            "items": {
-              "$ref": "#/components/schemas/MapCondition"
-            }
-          },
-          "mapping_attributes": {
-            "type": "array",
-            "description": "Attribute mappings",
-            "items": {
-              "anyOf": [
-                {
-                  "$ref": "#/components/schemas/MappingAttributeV2"
-                },
-                {
-                  "$ref": "#/components/schemas/MappingAttribute"
-                }
-              ]
-            }
-          },
-          "relation_attributes": {
-            "type": "array",
-            "description": "Relation mappings",
-            "items": {
-              "$ref": "#/components/schemas/RelationAttribute"
-            }
-          },
-          "linkback_relation_attribute": {
-            "type": "string",
-            "default": "mapped_entities",
-            "description": "Relation attribute on the main entity where the target entity will be linked. Set to false to disable linkback\n"
-          },
-          "linkback_relation_tags": {
-            "type": "array",
-            "description": "Relation tags (labels) to include in main entity linkback relation attribute",
-            "items": {
-              "type": "string"
-            }
-          },
-          "graph_context": {
-            "type": "array",
-            "description": "Multi-hop entity graph lookups resolved before any mapping_attribute is evaluated. Each\nentry queries entity-api's `POST /v1/entity:graph` and merges every node's result into\nsourceContext under its own `graph.nodes[].id`, so mapping_attributes can `_copy`/`_template`\nfrom `<node id>.<field>`. A graph node's value overwrites any existing sourceContext key of\nthe same name (a source entity field, a 1-hop relation, or another graph node).\n",
-            "items": {
-              "$ref": "#/components/schemas/GraphContextEntry"
-            }
-          }
-        },
-        "required": [
-          "target_schema",
-          "mapping_attributes"
-        ]
-      },
-      "MapCondition": {
-        "type": "object",
-        "properties": {
-          "_exists": {
-            "$ref": "#/components/schemas/ConditionNode"
-          },
-          "_equals": {
-            "$ref": "#/components/schemas/ConditionNode"
-          },
-          "_not_exists": {
-            "$ref": "#/components/schemas/ConditionNode"
-          },
-          "_any_of": {
-            "$ref": "#/components/schemas/ConditionNode"
-          }
-        }
-      },
-      "ConditionNode": {
-        "type": "object",
-        "properties": {
-          "source": {
-            "type": "string"
-          },
-          "value": {
-            "oneOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "number"
-              },
-              {
-                "type": "object"
-              },
-              {
-                "type": "array",
-                "items": {
-                  "type": "object"
-                }
-              }
-            ]
-          }
-        }
-      },
-      "RelationAttribute": {
-        "type": "object",
-        "properties": {
-          "target": {
-            "type": "string",
-            "description": "Target attribute to store the relation in"
-          },
-          "target_tags": {
-            "type": "array",
-            "description": "Relation tags (labels) to set for the stored relations",
-            "items": {
-              "type": "string"
-            }
-          },
-          "target_tags_include_source": {
-            "type": "boolean",
-            "description": "Include all relation tags (labels) present on the main entity relation",
-            "default": false
-          },
-          "target_entity_tags": {
-            "type": "array",
-            "description": "Tags to add to the matched target entity's _tags array during mapping. Useful for assigning file collections to file entities.",
-            "items": {
-              "type": "string"
-            }
-          },
-          "override_with_source_filter": {
-            "type": "boolean",
-            "description": "Whether to override the relation source_filter with the specified one",
-            "default": false
-          },
-          "source_filter": {
-            "type": "object",
-            "description": "A filter to identify which source entities to pick as relations from main entity",
-            "properties": {
-              "limit": {
-                "type": "integer",
-                "description": "Limit relations to maximum number (default, all matched relations)",
-                "minimum": 0
-              },
-              "schema": {
-                "type": "string",
-                "description": "Filter by specific schema"
-              },
-              "attribute": {
-                "type": "string",
-                "description": "Filter by a specific relation attribute on the main entity"
-              },
-              "relation_tag": {
-                "type": "string",
-                "description": "Filter by relation tag (label) on the main entity"
-              },
-              "tag": {
-                "type": "string",
-                "description": "Filter by a specific tag on the related entity"
-              },
-              "self": {
-                "type": "boolean",
-                "description": "Picks main entity as relation (overrides other filters)",
-                "default": false
-              }
-            }
-          },
-          "related_to": {
-            "type": "object",
-            "additionalProperties": true,
-            "deprecated": true
-          },
-          "mode": {
-            "type": "string",
-            "enum": [
-              "append",
-              "prepend",
-              "set"
-            ]
-          },
-          "origin": {
-            "$ref": "#/components/schemas/AttributeOrigin"
-          }
-        },
-        "required": [
-          "target",
-          "mode"
-        ]
-      },
-      "GraphContextEntry": {
-        "type": "object",
-        "description": "One multi-hop graph lookup against entity-api's `POST /v1/entity:graph`, resolved during\ngraph_context enrichment (before mapping_attributes are evaluated). Every node in `graph.nodes`\nis merged into sourceContext under its own `id`, so listing several nodes here costs one\nentity-api call, not one per node.\n\nIf a node's `cardinality` is \"one\" (or it is the seed node), exactly one entity must be found\nfor it: zero or multiple matches fail the mapping execution instead of silently mapping\nmissing/wrong data. If \"many\" (the default), it resolves to an array - possibly empty - with no\nsuch failure. Each node's cardinality is validated independently.\n\n`seed.entity_id` and any `graph.nodes[].filter[].value` may contain `{{handlebars}}` placeholders\n(e.g. `{{contract._id}}`, `{{contract.origin_order}}`), resolved against the in-progress\nsourceContext (the source entity, its 1-hop relations, and any custom variables already\nresolved) before the graph query is sent.\n",
-        "properties": {
-          "seed": {
-            "$ref": "#/components/schemas/GraphSeed"
-          },
-          "graph": {
-            "$ref": "#/components/schemas/GraphDefinition"
-          }
-        },
-        "required": [
-          "seed",
-          "graph"
-        ]
-      },
-      "GraphSeed": {
-        "description": "Mirrors entity-api's GraphSeed (see entity-api openapi.yml) - the entity the graph traversal starts from.",
-        "type": "object",
-        "properties": {
-          "entity_id": {
-            "type": "string",
-            "description": "The id of the seed entity. Supports `{{handlebars}}` placeholders resolved against sourceContext.",
-            "example": "{{contract._id}}"
-          },
-          "node_id": {
-            "type": "string",
-            "description": "The node ID in `graph.nodes` that corresponds to the seed entity.",
-            "example": "contact"
-          }
-        },
-        "required": [
-          "entity_id",
-          "node_id"
-        ]
-      },
-      "GraphDefinition": {
-        "description": "Mirrors entity-api's GraphDefinition (see entity-api openapi.yml) - the shape of the graph to traverse.",
-        "type": "object",
-        "properties": {
-          "nodes": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/GraphNode"
-            }
-          },
-          "edges": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/GraphEdge"
-            }
-          }
-        },
-        "required": [
-          "nodes",
-          "edges"
-        ]
-      },
-      "GraphNode": {
-        "description": "Mirrors entity-api's GraphNode (see entity-api openapi.yml).",
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "description": "Unique identifier for this node in the graph definition.",
-            "example": "contact"
-          },
-          "schema": {
-            "type": "string",
-            "description": "Entity schema slug for this node.",
-            "example": "contact"
-          },
-          "cardinality": {
-            "type": "string",
-            "enum": [
-              "one",
-              "many"
-            ],
-            "description": "\"one\": this node resolves to a single entity. \"many\" (default if unset): this node\nresolves to an array of entities.\n"
-          },
-          "fields": {
-            "type": "array",
-            "description": "Optional entity fields to include in the hydrated response for this node.",
-            "items": {
-              "type": "string"
-            }
-          },
-          "filter": {
-            "type": "array",
-            "description": "Narrows this node's traversal results to entities matching every filter (AND semantics).\nUseful for disambiguating among multiple entities reachable via the same graph edge.\n",
-            "items": {
-              "$ref": "#/components/schemas/GraphNodeFilter"
-            }
-          },
-          "optional": {
-            "type": "boolean",
-            "description": "Only meaningful for a node expected to resolve to a single entity (the seed node, or\n\"cardinality: one\"). When true, finding zero matching entities is not an error - the\nmapping proceeds without this node's data instead of failing. Finding more than one\nmatch still fails regardless of this flag; ambiguity is never silently accepted.\n"
-          }
-        },
-        "required": [
-          "id",
-          "schema"
-        ]
-      },
-      "GraphNodeFilter": {
-        "description": "Mirrors entity-api's GraphNodeFilter (see entity-api openapi.yml).",
-        "type": "object",
-        "properties": {
-          "attribute": {
-            "type": "string",
-            "description": "Entity attribute name to match against.",
-            "example": "order_number"
-          },
-          "value": {
-            "description": "Literal value the attribute must exactly equal. Supports `{{handlebars}}` placeholders\nresolved against sourceContext when given as a string.\n",
-            "oneOf": [
-              {
-                "type": "string",
-                "nullable": true
-              },
-              {
-                "type": "number"
-              },
-              {
-                "type": "boolean"
-              }
-            ],
-            "example": "{{contract.origin_order}}"
-          }
-        },
-        "required": [
-          "attribute",
-          "value"
-        ]
-      },
-      "GraphEdge": {
-        "description": "Mirrors entity-api's GraphEdge (see entity-api openapi.yml).",
-        "type": "object",
-        "properties": {
-          "from": {
-            "type": "string",
-            "description": "Source node ID.",
-            "example": "contact"
-          },
-          "to": {
-            "type": "string",
-            "description": "Target node ID.",
-            "example": "order"
-          }
-        },
-        "required": [
-          "from",
-          "to"
-        ]
-      },
-      "MappingAttributeV2": {
-        "type": "object",
-        "properties": {
-          "target": {
-            "type": "string",
-            "description": "Target JSON path for the attribute to set"
-          },
-          "operation": {
-            "$ref": "#/components/schemas/OperationNode"
-          },
-          "origin": {
-            "$ref": "#/components/schemas/AttributeOrigin"
-          }
-        },
-        "required": [
-          "target",
-          "operation"
-        ],
-        "example": {
-          "target": "_tags",
-          "operation": {
-            "_append": [
-              "new",
-              "tags"
-            ],
-            "_uniq": true
-          }
-        }
-      },
-      "AttributeOrigin": {
-        "type": "string",
-        "description": "Origin of an attribute.",
-        "enum": [
-          "system_recommendation",
-          "user_manually",
-          "entity_updating_system_recommendation"
-        ]
-      },
-      "OperationNode": {
-        "description": "Mapping operation nodes are either primitive values or operation node objects",
-        "oneOf": [
-          {
-            "$ref": "#/components/schemas/OperationObjectNode"
-          },
-          {
-            "$ref": "#/components/schemas/PrimitiveJSONValue"
-          }
-        ]
-      },
-      "OperationObjectNode": {
-        "type": "object",
-        "properties": {
-          "_set": {
-            "$ref": "#/components/schemas/PrimitiveJSONValue"
-          },
-          "_append": {
-            "description": "Append to array",
-            "items": {
-              "$ref": "#/components/schemas/PrimitiveJSONValue"
-            }
-          },
-          "_prepend": {
-            "description": "Prepend to an array",
-            "items": {
-              "$ref": "#/components/schemas/OperationNode"
-            }
-          },
-          "_uniq": {
-            "description": "Unique array",
-            "oneOf": [
-              {
-                "type": "boolean",
-                "example": true
-              },
-              {
-                "type": "array",
-                "description": "Unique key consisting of object keys",
-                "example": [
-                  "email"
-                ],
-                "items": {
-                  "type": "string"
-                }
-              }
-            ]
-          },
-          "_retain_old_values": {
-            "description": "Merge strategy when _uniq is defined",
-            "type": "boolean",
-            "example": true
-          },
-          "_copy": {
-            "description": "Copy JSONPath value from source entity context",
-            "type": "string",
-            "example": "contact.first_name"
-          },
-          "_template": {
-            "description": "Define handlebars template to output a string",
-            "type": "string",
-            "example": "{{contact.first_name}} {{contact.last_name}}"
-          },
-          "_random": {
-            "description": "Generate random ids / numbers",
-            "$ref": "#/components/schemas/RandomOperation"
-          },
-          "_each": {
-            "description": "Iterate over a source array. Use with _as and _map.\nThe value is a path to resolve from the source entity context.\nExample: \"submission.meterReadings\"\n",
-            "type": "string",
-            "example": "submission.meterReadings"
-          },
-          "_as": {
-            "description": "Name for the current iteration item in _each.\nAccessed as $<name> in _copy paths within _map.\nExample: \"reading\" (accessed as $reading)\n",
-            "type": "string",
-            "example": "reading"
-          },
-          "_map": {
-            "description": "Operation to evaluate per _each iteration item.\nCan be any OperationNode, typically an object with _copy\nreferences to the $<_as name> alias.\n",
-            "$ref": "#/components/schemas/OperationNode"
-          }
-        },
-        "additionalProperties": true
-      },
-      "PrimitiveJSONValue": {
-        "description": "Represents any primitive JSON value",
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "number"
-          },
-          {
-            "type": "object",
-            "additionalProperties": true
-          },
-          {
-            "type": "array"
-          }
-        ]
-      },
-      "RandomOperation": {
-        "oneOf": [
-          {
-            "type": "object",
-            "properties": {
-              "type": {
-                "type": "string",
-                "enum": [
-                  "uuid",
-                  "nanoid"
-                ]
-              }
-            },
-            "required": [
-              "type"
-            ]
-          },
-          {
-            "type": "object",
-            "properties": {
-              "type": {
-                "type": "string",
-                "enum": [
-                  "number"
-                ]
-              },
-              "min": {
-                "type": "number",
-                "default": 0
-              },
-              "max": {
-                "type": "number",
-                "default": 1
-              }
-            },
-            "required": [
-              "type"
-            ]
-          }
-        ]
-      },
-      "MappingAttribute": {
-        "anyOf": [
-          {
-            "$ref": "#/components/schemas/SetValueMapper"
-          },
-          {
-            "$ref": "#/components/schemas/CopyValueMapper"
-          },
-          {
-            "$ref": "#/components/schemas/AppendValueMapper"
-          }
-        ]
-      },
-      "MappingAttributeMode": {
-        "type": "string",
-        "enum": [
-          "copy_if_exists",
-          "append_if_exists",
-          "set_value"
-        ],
-        "description": "- copy_if_exists - it replaces the target attribute with the source value - append_if_exists - it currently replaces target attribute with array like values. Useful when you have multiple values to be added into one attribute. - set_value - it sets a value to a predefined value. Must be used together with value property.\n"
-      },
-      "SetValueMapper": {
-        "type": "object",
-        "deprecated": true,
-        "properties": {
-          "mode": {
-            "$ref": "#/components/schemas/MappingAttributeMode"
-          },
-          "target": {
-            "type": "string",
-            "description": "JSON like target path for the attribute. Eg. last_name"
-          },
-          "value": {
-            "description": "Any value to be set: string, number, string[], number[], JSON object, etc. It will override existing values, if any.\n"
-          }
-        },
-        "required": [
-          "mode",
-          "target",
-          "value"
-        ]
-      },
-      "CopyValueMapper": {
-        "type": "object",
-        "deprecated": true,
-        "properties": {
-          "mode": {
-            "$ref": "#/components/schemas/MappingAttributeMode"
-          },
-          "target": {
-            "type": "string",
-            "description": "JSON like target path for the attribute. Eg. last_name"
-          },
-          "source": {
-            "type": "string",
-            "description": "JSON source path for the value to be extracted from the main entity. Eg: steps[1].['Product Info'].price\n"
-          }
-        },
-        "required": [
-          "mode",
-          "target",
-          "source"
-        ]
-      },
-      "AppendValueMapper": {
-        "type": "object",
-        "deprecated": true,
-        "properties": {
-          "mode": {
-            "$ref": "#/components/schemas/MappingAttributeMode"
-          },
-          "target": {
-            "type": "string",
-            "description": "JSON like target path for the attribute. Eg. last_name"
-          },
-          "source": {
-            "type": "string",
-            "description": "JSON source path for the value to be extracted from the main entity. Eg: steps[1].['Product Info'].price\n"
-          },
-          "value_json": {
-            "type": "string",
-            "description": "To be provided only when mapping json objects into a target attribute. Eg array of addresses.\n"
-          },
-          "target_unique": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Array of keys which should be used when checking for uniqueness. Eg: [country, city, postal_code]\n"
-          }
-        },
-        "required": [
-          "mode",
-          "target",
-          "value_json"
-        ]
-      },
-      "MappingHistoryResp": {
-        "type": "object",
-        "properties": {
-          "results": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/MappingHistoryEntry"
-            }
-          }
-        },
-        "required": [
-          "results"
-        ]
-      },
-      "MappingHistoryEntry": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "string",
-            "example": "70542580-2b38-4bfc-af8d-bb90102f9f47"
-          },
-          "timestamp": {
-            "type": "string",
-            "format": "ISO datetime"
-          },
-          "source_entity_snapshot": {
-            "$ref": "#/components/schemas/Entity"
-          },
-          "mapped_entities_snapshot": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Entity"
-            }
-          },
-          "target_configs_snapshot": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/TargetConfig"
-            }
-          }
-        },
-        "required": [
-          "id",
-          "timestamp",
-          "source_entity_snapshot",
-          "target_configs_snapshot",
-          "mapped_entities_snapshot"
-        ]
-      },
-      "MappingSource": {
-        "type": "object",
-        "properties": {
-          "key": {
-            "type": "string",
-            "description": "Key aiming to identify source"
-          },
-          "sub_properties": {
-            "description": "Each item describes a property under the main source and a possibly, a default value for its target attribute",
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/MappingSourceProperty"
-            }
-          },
-          "source_type": {
-            "type": "string",
-            "description": "Data Structure type of source"
-          },
-          "group": {
-            "type": "string",
-            "description": "A group this source belongs to. Used for grouping sources in the UI"
-          },
-          "possible_target_types": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/MappingSourceTargetType"
-            },
-            "description": "Data Structure Type of the underlaying output value"
-          },
-          "initial_relation": {
-            "description": "Initial value of a relation to be added",
-            "$ref": "#/components/schemas/RelationAttribute"
-          },
-          "title": {
-            "type": "string",
-            "description": "Human readable name of the Source"
-          },
-          "sub_title": {
-            "type": "string",
-            "description": "Human readable type of the source"
-          },
-          "repeatable": {
-            "type": "boolean",
-            "description": "Whether the source (block or attribute) is a repeatable, aka holds a list of values"
-          },
-          "target_settings": {
-            "type": "object",
-            "properties": {
-              "allowed_ui_actions": {
-                "type": "array",
-                "items": {
-                  "type": "string",
-                  "enum": [
-                    "schema-select",
-                    "attribute-select",
-                    "target-delete",
-                    "target-add",
-                    "target"
-                  ]
-                },
-                "description": "Describes which actions the user can perform on each target, if specified. If not specified, all actions are allowed"
-              },
-              "locked": {
-                "type": "string",
-                "enum": [
-                  "each",
-                  "first",
-                  "system_recommendation"
-                ],
-                "description": "Whether its a read-only ui or not. Can be each target, or only the first. Overwrites uiActions"
-              },
-              "isSingleTarget": {
-                "type": "boolean",
-                "description": "Whether all source mappings flow into a single attribute (e.g. address)"
-              },
-              "visibility": {
-                "description": "Determines whether a mapping target should be shown or not. Use if there are targets which cannot be manipulated by the UI. E.g journey_data",
-                "type": "object",
-                "properties": {
-                  "mode": {
-                    "type": "string",
-                    "enum": [
-                      "hide",
-                      "show",
-                      "message"
-                    ]
-                  },
-                  "if": {
-                    "type": "object",
-                    "additionalProperties": {
-                      "type": "string"
-                    }
-                  },
-                  "message": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "mode",
-                  "if"
-                ]
-              }
-            }
-          }
-        },
-        "required": [
-          "key",
-          "title",
-          "source_type"
-        ]
-      },
-      "MappingSourceProperty": {
-        "type": "object",
-        "properties": {
-          "value": {
-            "type": "string"
-          },
-          "label": {
-            "type": "string"
-          },
-          "initial_target_value": {
-            "type": "string"
-          },
-          "possible_target_types": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/MappingSourceTargetType"
-            },
-            "description": "Data Structure Type of the underlaying output value"
-          },
-          "raw": {
-            "type": "boolean",
-            "description": "Whether the raw value should be used, or whether the value is enriched by a path"
-          }
-        },
-        "required": [
-          "value",
-          "label"
-        ]
-      },
-      "MappingSourceTargetType": {
-        "type": "string",
-        "enum": [
-          "string",
-          "date",
-          "datetime",
-          "boolean",
-          "number",
-          "image",
-          "file",
-          "address",
-          "email",
-          "phone",
-          "select",
-          "multiselect",
-          "payment",
-          "link",
-          "currency",
-          "sequence",
-          "relation",
-          "array"
-        ]
-      }
-    }
-  },
-  "servers": [
-    {
-      "url": "https://entity-mapping.sls.epilot.io"
-    }
-  ]
-}