---
title: "Import terminology from CSV or ACTIF XML"
method: POST
path: "/brand-terms/"
tags: ["brandTerms"]
---

# Import terminology from CSV or ACTIF XML

`POST /brand-terms/`

Uploads a CSV or ACTIF XML file and imports terminology.

**CSV Format Requirements:**
- CSV must include columns: Prohibited, Preferred, Context, Context Polarity, Domains
- The first row must contain the column headers in the exact same order as shown above
- Context Polarity accepts 'include', 'exclude', or an empty value. 'include' means the context describes when the term rule applies; 'exclude' means the context describes when the term rule does NOT apply; an empty value means no polarity is set.
- Multiple values within a single cell should be separated by semicolons with a space (e.g., term1; term2; term3)
- Empty cells are allowed
- The CSV import format is the same as the CSV export format.

## Query parameters

- `delete_existing` boolean

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- ImportSummary
  - `entries_processed` integer
  - `term_sets_created` integer
  - `term_sets_deleted` integer
  - `terms_created_or_updated` integer
  - `domains_created` integer
  - `domains_deleted` integer
  - `errors` string[]

## Other responses

- `401` — Authentication failed or no valid API key provided.
- `403` — Forbidden
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/markup/apis/api-reference.md) · [All operations](https://skmtc.net/markup/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/markup/api-reference/revisions/8e28e770c55d/schema)