---
updatedAt: 2026-02-20T12:54:55.000Z
agentTools:
  projectIndex: https://api-docs.hevodata.com/llms.txt
---

# Update Schema Mapping of an Event type

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Hevo Data",
    "description": "Hevo Data APIs allow users to manage their Pipelines in Hevo.<br/><br/>API Key and API Secret can be generated from `Account` > `API Keys` on Hevo UI.<br/>The key and secret generated should be used as Basic auth username and password to authenticate access.",
    "version": "v2.0"
  },
  "servers": [
    {
      "url": "https://us.hevodata.com"
    },
    {
      "url": "https://us2.hevodata.com"
    },
    {
      "url": "https://eu.hevodata.com"
    },
    {
      "url": "https://in.hevodata.com"
    },
    {
      "url": "https://asia.hevodata.com"
    },
    {
      "url": "https://au.hevodata.com"
    }
  ],
  "security": [
    {
      "BasicAuth": []
    }
  ],
  "paths": {
    "/api/public/v2.0/pipelines/{id}/mappings/{event_type}": {
      "put": {
        "tags": [
          "Schema Mappings"
        ],
        "summary": "Update Schema Mapping of an Event type",
        "operationId": "updateSchemaMapping",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "event_type",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExUpdateSchemaMappingRequestDTO"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Schema Mapping update response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExMappingUpdateResponse"
                }
              }
            }
          },
          "400": {
            "description": "Destination table doesn't exist. Create a table to map the Event schema."
          },
          "404": {
            "description": "Pipeline not found."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ExMappingUpdateResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "ExFieldMappingUpdateRequestDTO": {
        "type": "object",
        "properties": {
          "source_field": {
            "type": "string"
          },
          "destination_field": {
            "type": "string"
          },
          "ignored": {
            "type": "boolean"
          }
        }
      },
      "ExUpdateSchemaMappingRequestDTO": {
        "type": "object",
        "properties": {
          "destination_table": {
            "type": "string"
          },
          "field_mappings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExFieldMappingUpdateRequestDTO"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "BasicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```