Contentstack introduces the Agentic Experience Platform | Press release
Contentstack introduces the Agentic Experience Platform | Press release
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs
  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing
  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases
  • Academy
  • Docs
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP
  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support
  • Overview
  • Find a partner
  • Login
  • About us
  • News
  • Customer support portal
  • Contact
  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.

AI Assistant

Ask a question below...

infoAI responses may contain mistakes.
/
  1. Home
  2. APIs
  3. Personalize Management API
  4. Attributes

Attributes

markdownView as Markdown

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

POSThttps://personalize-api.contentstack.com/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.

Sample Request
12345
{
  "name": "Age",
  "key": "age",
  "description": "Age of the visitor"
}
Sample Response
Status|201 Created
1234567891011121314
{
  "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

GEThttps://personalize-api.contentstack.com/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.

Sample Response
Status|200 OK
12345678910111213141516
[
  {
    "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

PUThttps://personalize-api.contentstack.com/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.

Sample Request
12345
{
  "name": "Visitor Age",
  "key": "age",
  "description": "Age of the visitor from profile"
}
Sample Response
Status|200 OK
1234567891011121314
{
  "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

DELETEhttps://personalize-api.contentstack.com/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.

Sample Response
Status|204 No Content
1
The attributes were deleted successfully
Hide Parameters

Headers

authorizationoptionalstring

Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth

authtokenoptionalstring

Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens

x-project-uidrequiredstring

Hide Parameters

Headers

authorizationoptionalstring

Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth

authtokenoptionalstring

Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens

x-project-uidrequiredstring

Hide Parameters

URL Parameters

uidrequiredstring

Enter the Attribute UID to be updated.

Headers

authorizationoptionalstring

Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth

authtokenoptionalstring

Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens

x-project-uidrequiredstring

Hide Parameters

URL Parameters

uidrequiredstring

Enter the Attribute UID to be deleted.

Headers

authorizationoptionalstring

Enter your OAuth token here. Read more: https://www.contentstack.com/docs/developers/developer-hub/contentstack-oauth

authtokenoptionalstring

Enter your authtoken here. Read more: https://www.contentstack.com/docs/developers/create-tokens/types-of-tokens#authentication-tokens-authtokens

x-project-uidrequiredstring