---
title: "/api/v{version}/attributes/{attributeType}/add"
slug: "apivversionattributesattributetypeadd-2"
updated: 2025-08-20T01:02:48Z
published: 2026-03-20T12:47:08Z
canonical: "docs.grassfish.com/apivversionattributesattributetypeadd-2"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grassfish.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /api/v{version}/attributes/{attributeType}/add

Post/api/v{version}/attributes/{attributeType}/add

SecurityOAuth

Authorization using OAuth2 with Client Credentials

FlowClient Credentials Authorization URLhttps://identity.eu01.grassfish.com/connect/authorize
Token URLhttps://identity.eu01.grassfish.com/connect/token
		

Header parametersx-correlationTokenstring
x-clientIdstringMin length0Max length128
x-onBehalfOfstringMin length0Max length24
api-versionstring

Path parametersattributeTypestringRequiredValid values[
  "None",
  "Item",
  "POSItem",
  "ClientLocationPlayer",
  "Offer",
  "Assortment",
  "Record",
  "AssortmentItem",
  "TreeSchemaLevel"
]
versionstringRequired

Body parameters<select class='api-response-data' aria-label='Media type'><option value='3ac00d86-3ee8-4cf3-bebb-9856148f132c'>application/json</option>
<option value='4cd9e464-10eb-4485-b973-7c8f77594bab'>text/json</option>
<option value='193c0761-4115-498e-b1ac-ecfb135b3d8f'>application/*+json</option>
</select>Expand Allobject  attributes Array of object (Contracts.Connect.Parameters.ModifySingleAttribute)  | null  object  codestring   | null  Min length0Max length24
idstring   | null  Min length0Max length128
namestring   | null  Min length0Max length50
descriptionstring   | null  Min length0Max length256
orderNinteger  (int32)    
readOnlyboolean   | null  
flagsstring    Valid values[
  "None",
  "Mandatory",
  "Default",
  "Share",
  "ValidityPeriod",
  "Options",
  "Fixed",
  "Multi",
  "ShowAsListColumn"
]
valueTypestring    Valid values[
  "String",
  "Currency",
  "Day",
  "DateTime",
  "Int",
  "Float",
  "Media",
  "DatePeriod",
  "Record",
  "Bool",
  "Slider"
]
maxLengthinteger  (int32)    
mediaLibrarystring    Valid values[
  "None",
  "BookingMedia",
  "Logos",
  "OfferMedia",
  "ItemImages",
  "HtmlTemplates",
  "HousingAds",
  "BookingCommentFiles",
  "Maps",
  "PlayerScreenShots",
  "ADinQ",
  "Facebook",
  "PlayoutEntities",
  "Instagram",
  "WebPages",
  "Unsplash",
  "Documents",
  "FallbackMedia",
  "OfferSigns",
  "HtmlTemplateSystemFiles",
  "ImportDocuments"
]
options Array of string  | null  string    
attributes Array of object (Contracts.Connect.Parameters.ModifySingleAttribute)  | null  object Recursive  
placeholderstring   | null  

Expand Allobject  attributes Array of object (Contracts.Connect.Parameters.ModifySingleAttribute)  | null  object  codestring   | null  Min length0Max length24
idstring   | null  Min length0Max length128
namestring   | null  Min length0Max length50
descriptionstring   | null  Min length0Max length256
orderNinteger  (int32)    
readOnlyboolean   | null  
flagsstring    Valid values[
  "None",
  "Mandatory",
  "Default",
  "Share",
  "ValidityPeriod",
  "Options",
  "Fixed",
  "Multi",
  "ShowAsListColumn"
]
valueTypestring    Valid values[
  "String",
  "Currency",
  "Day",
  "DateTime",
  "Int",
  "Float",
  "Media",
  "DatePeriod",
  "Record",
  "Bool",
  "Slider"
]
maxLengthinteger  (int32)    
mediaLibrarystring    Valid values[
  "None",
  "BookingMedia",
  "Logos",
  "OfferMedia",
  "ItemImages",
  "HtmlTemplates",
  "HousingAds",
  "BookingCommentFiles",
  "Maps",
  "PlayerScreenShots",
  "ADinQ",
  "Facebook",
  "PlayoutEntities",
  "Instagram",
  "WebPages",
  "Unsplash",
  "Documents",
  "FallbackMedia",
  "OfferSigns",
  "HtmlTemplateSystemFiles",
  "ImportDocuments"
]
options Array of string  | null  string    
attributes Array of object (Contracts.Connect.Parameters.ModifySingleAttribute)  | null  object Recursive  
placeholderstring   | null  

Expand Allobject  attributes Array of object (Contracts.Connect.Parameters.ModifySingleAttribute)  | null  object  codestring   | null  Min length0Max length24
idstring   | null  Min length0Max length128
namestring   | null  Min length0Max length50
descriptionstring   | null  Min length0Max length256
orderNinteger  (int32)    
readOnlyboolean   | null  
flagsstring    Valid values[
  "None",
  "Mandatory",
  "Default",
  "Share",
  "ValidityPeriod",
  "Options",
  "Fixed",
  "Multi",
  "ShowAsListColumn"
]
valueTypestring    Valid values[
  "String",
  "Currency",
  "Day",
  "DateTime",
  "Int",
  "Float",
  "Media",
  "DatePeriod",
  "Record",
  "Bool",
  "Slider"
]
maxLengthinteger  (int32)    
mediaLibrarystring    Valid values[
  "None",
  "BookingMedia",
  "Logos",
  "OfferMedia",
  "ItemImages",
  "HtmlTemplates",
  "HousingAds",
  "BookingCommentFiles",
  "Maps",
  "PlayerScreenShots",
  "ADinQ",
  "Facebook",
  "PlayoutEntities",
  "Instagram",
  "WebPages",
  "Unsplash",
  "Documents",
  "FallbackMedia",
  "OfferSigns",
  "HtmlTemplateSystemFiles",
  "ImportDocuments"
]
options Array of string  | null  string    
attributes Array of object (Contracts.Connect.Parameters.ModifySingleAttribute)  | null  object Recursive  
placeholderstring   | null  

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='f2af66c7-0499-4f00-8583-f6b9a2352cd8'>text/plain</option>
<option value='e0f5c91d-fbd6-4926-8a5b-aa9dc86bfa78'>application/json</option>
<option value='9f748d25-07df-46a3-8186-b345ee79696c'>text/json</option>
</select>Expand Allobject  successobject (Contracts.Common.Jsons.Common.SuccessJson)  okboolean    
messagestring   | null  
unauthorizedAccessboolean   | null  
notFoundboolean   | null  
correlationTokenstring   | null  
errors Array of object (Contracts.Common.Jsons.Common.SuccessJsonError)  | null  object  messagestring   | null  
idstring    Valid values[
  "InvalidDatePeriodEndDateBeforeStartDate",
  "NameAlreadyTaken",
  "ExternalIdAlreadyTaken",
  "CodeAlreadyTaken"
]
fieldNamestring   | null  
isRequiredboolean   | null  
isOutOfRangeboolean   | null  
isTakenboolean   | null  
errorCodestring   | null  
defaultDisplayMessagestring   | null  

errorCodestring   | null  
detailsobject (Contracts.Common.Jsons.Common.ErrorDetailsJson)  messagestring   | null  
defaultDisplayMessagestring   | null  

Expand Allobject  successobject (Contracts.Common.Jsons.Common.SuccessJson)  okboolean    
messagestring   | null  
unauthorizedAccessboolean   | null  
notFoundboolean   | null  
correlationTokenstring   | null  
errors Array of object (Contracts.Common.Jsons.Common.SuccessJsonError)  | null  object  messagestring   | null  
idstring    Valid values[
  "InvalidDatePeriodEndDateBeforeStartDate",
  "NameAlreadyTaken",
  "ExternalIdAlreadyTaken",
  "CodeAlreadyTaken"
]
fieldNamestring   | null  
isRequiredboolean   | null  
isOutOfRangeboolean   | null  
isTakenboolean   | null  
errorCodestring   | null  
defaultDisplayMessagestring   | null  

errorCodestring   | null  
detailsobject (Contracts.Common.Jsons.Common.ErrorDetailsJson)  messagestring   | null  
defaultDisplayMessagestring   | null  

Expand Allobject  successobject (Contracts.Common.Jsons.Common.SuccessJson)  okboolean    
messagestring   | null  
unauthorizedAccessboolean   | null  
notFoundboolean   | null  
correlationTokenstring   | null  
errors Array of object (Contracts.Common.Jsons.Common.SuccessJsonError)  | null  object  messagestring   | null  
idstring    Valid values[
  "InvalidDatePeriodEndDateBeforeStartDate",
  "NameAlreadyTaken",
  "ExternalIdAlreadyTaken",
  "CodeAlreadyTaken"
]
fieldNamestring   | null  
isRequiredboolean   | null  
isOutOfRangeboolean   | null  
isTakenboolean   | null  
errorCodestring   | null  
defaultDisplayMessagestring   | null  

errorCodestring   | null  
detailsobject (Contracts.Common.Jsons.Common.ErrorDetailsJson)  messagestring   | null  
defaultDisplayMessagestring   | null  

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='d910ff67-ae9a-4007-b619-7fb98f5efa52'>text/plain</option>
<option value='b590789d-9da9-453e-b66f-5786df5dffba'>application/json</option>
<option value='1462b76e-5bc3-497f-91fc-9c5a403df9ac'>text/json</option>
</select>object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

401

Unauthorized

403

Forbidden

<select class='api-response-data' aria-label='Media type'><option value='db5b0598-685a-4308-8754-1e1beecfb5df'>text/plain</option>
<option value='49bfbf7c-4c68-4cdc-8642-a3369b6edfe4'>application/json</option>
<option value='5ed0b5d8-19e9-4960-abd9-7289715601e9'>text/json</option>
</select>object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

object  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
property*

500

Internal Server Error