---
title: "Attributes"
description: "<p>Attributes are the individual data points or characteristics about a user that can be used to personalize content, recommendations, and experiences for that user. For example age, location, browsing history, purchases, campaign sources, and so on.</p>"
url: "https://www.contentstack.com/docs/developers/apis/personalize-management-api/attributes"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-04-24"
---

# Attributes

Attributes are the individual data points or characteristics about a user that can be used to personalize content, recommendations, and experiences for that user. For example age, location, browsing history, purchases, campaign sources, and so on.

## Create an Attribute

### Create an Attribute

**POST** `/attributes`

The Create an Attribute request lets you create a new attribute in a project.

To configure the permissions for your application via OAuth, include the personalize:manage scope.

#### Headers

- **authorization** (optional)
  Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth
- **authtoken** (optional)
  Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens
- **x-project-uid** (required)

#### Sample Response

```json
{
  "name": "Age",
  "key": "age",
  "description": "Age of the visitor",
  "project": "64c7787b333555469a861224",
  "createdBy": "bxxxxxxxxxxxx3",
  "updatedBy": "bxxxxxxxxxxxx6",
  "createdAt": "2024-03-13T15:39:51.645Z",
  "updatedAt": "2024-03-13T15:39:51.645Z",
  "uid": "6xxxxxxxxxx2",
  "createdByUserName": "Jane Doe",
  "updatedByUserName": "Jane Doe",
  "__type": "CUSTOM"
}
```

## Get all Attributes

### Get all Attributes

**GET** `/attributes`

The Get all Attributes request fetches the list of all the attributes in a project.

To configure the permissions for your application via OAuth, include the personalize:read or personalize:manage scope.

#### Headers

- **authorization** (optional)
  Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth
- **authtoken** (optional)
  Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens
- **x-project-uid** (required)

#### Sample Response

```json
[
  {
    "name": "Age",
    "key": "age",
    "description": "Age of the visitor",
    "project": "64c7787b333555469a861224",
    "createdBy": "bxxxxxxxxxxxx3",
    "updatedBy": "bxxxxxxxxxxxx6",
    "createdAt": "2024-03-13T15:39:51.645Z",
    "updatedAt": "2024-03-13T15:39:51.645Z",
    "uid": "6xxxxxxxxxx2",
    "createdByUserName": "Jane Doe",
    "updatedByUserName": "Jane Doe",
    "__type": "CUSTOM"
  }
]
```

## Update an Attribute

### Update an Attribute

**PUT** `/attributes/{uid}`

The Update an Attribute request lets you update an existing attribute in a project.

To configure the permissions for your application via OAuth, include the personalize:manage scope.

#### URL Parameters

- **uid** (required)
  Enter the Attribute UID to be updated.

#### Headers

- **authorization** (optional)
  Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth
- **authtoken** (optional)
  Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens
- **x-project-uid** (required)

#### Sample Response

```json
{
  "name": "Visitor Age",
  "key": "age",
  "description": "Age of the visitor from profile",
  "project": "64c7787b333555469a861224",
  "createdBy": "bxxxxxxxxxxxx3",
  "updatedBy": "bxxxxxxxxxxxx6",
  "createdAt": "2024-03-13T15:39:51.645Z",
  "updatedAt": "2024-03-13T15:40:00.000Z",
  "uid": "6xxxxxxxxxx2",
  "createdByUserName": "Jane Doe",
  "updatedByUserName": "Jane Doe",
  "__type": "CUSTOM"
}
```

## Delete an Attribute

### Delete an Attribute

**DELETE** `/attributes/{uid}`

The Delete an Attribute request lets you delete an existing attribute in a project.

To configure the permissions for your application via OAuth, include the personalize:manage scope.

#### URL Parameters

- **uid** (required)
  Enter the Attribute UID to be deleted.

#### Headers

- **authorization** (optional)
  Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth
- **authtoken** (optional)
  Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens
- **x-project-uid** (required)

#### Sample Response

```json
The attributes were deleted successfully
```