---
title: "Suggest attribute mappings for a not-yet-created egress template"
method: POST
path: "/api/v1/egress-templates/suggest-mappings"
tags: ["EgressTemplate"]
---

# Suggest attribute mappings for a not-yet-created egress template

`POST /api/v1/egress-templates/suggest-mappings`

Given a list of column names parsed client-side from an uploaded file (CP-35814), returns ranked attribute-catalog suggestions per column, fuzzy-matched against the entity type's egress field catalog. The egress counterpart of the ingress /templates/scratch/suggest-mappings endpoint.

## Headers

- `tenant-id` string

## Request body

- SuggestEgressColumnMappingsRequest
  - `entityType` string
  - `columnNames` string[]
  - `sampleValues` array[]
    - string[]

## Response `200`

Suggestions generated successfully

- EgressFieldSuggestion[]
  - `name` string
  - `suggestedMatches` EgressFieldCatalogItem[]
    - `key` string
    - `label` string
    - `entityGroup` string
    - `dataType` string
    - `isDate` boolean
    - `isExpandable` boolean
    - `isSensitive` boolean

## Other responses

- `400` — Missing/unsupported entity type or too many columns
- `401` — Unauthorized
- `403` — Forbidden - Insufficient permissions

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)