---
title: "Add or update attributes"
method: POST
path: "/v1/data_index/attributes"
tags: ["Data Index"]
---

# Add or update attributes

`POST /v1/data_index/attributes`

Attributes are customer data like their name and email. Use this endpoint to add new attributes or update existing attributes in your workspace. To add attributes to customers, use our Pipelines or Track APIs. **NOTE:** If you add new attributes, they will not appear in your [Data Index](/journeys/people/find/using-data-index/) until you've added it to a customer's profile.

Add descriptions for attributes [so our AI tools can better understand your data](/ai/cio-with-llms/). For instance, this influences how our segment builder generates conditions with AI.

If you're on a Premium plan, you can also specify [whether an attribute is sensitive or not](/accounts/settings/team/intro-account-access/#hide-sensitive-attributes). Then Admins and Workspace Admins can decide which teammates to hide sensitive data from.

## Request body

- object
  - `attributes` object[], required — Array of attribute updates
    - `name` string, required — The name of the attribute to update
    - `description` string — The purpose of the attribute. This helps our AI tools understand your data.
    - `privacy_level` 0 | 1 — Available on Premium plans. This indicates whether an attribute is sensitive or not. 0 means NOT sensitive. 1 means sensitive.

## Response `204`

Attributes updated successfully

## Other responses

- `400` — Invalid request format
- `422` — Validation error
- `500` — Internal server error

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)