# Attribute

Attribute sets and configuration groups

## Retrieve attribute set configuration

> Returns configuration details for an attribute set, including variant attribute definitions.\
> \
> \*\*Attribute Sets:\*\*\
> An attribute set defines the schema for products, specifying:\
> \* Which attributes a product can have\
> \* Which attributes define variants (e.g., size, color)\
> \* Which variant attributes should appear in listings\
> \
> \*\*Response Includes:\*\*\
> \* \`variant\_attributes\`: Attribute keys that define unique variants\
> \* \`variant\_listable\_attributes\`: Attributes shown in product listings for variant differentiation

```json
{"openapi":"3.1.0","info":{"title":"Product API - Product Catalog & Detail Information","version":"1.0.0"},"tags":[{"name":"Attribute","description":"Attribute sets and configuration groups"}],"servers":[{"description":"Commerce API Server","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL (e.g., your-store.akinon.com)"}}}],"paths":{"/attribute_set/{pk}/":{"get":{"tags":["Attribute"],"operationId":"getAttributeSetDetail","summary":"Retrieve attribute set configuration","description":"Returns configuration details for an attribute set, including variant attribute definitions.\n\n**Attribute Sets:**\nAn attribute set defines the schema for products, specifying:\n* Which attributes a product can have\n* Which attributes define variants (e.g., size, color)\n* Which variant attributes should appear in listings\n\n**Response Includes:**\n* `variant_attributes`: Attribute keys that define unique variants\n* `variant_listable_attributes`: Attributes shown in product listings for variant differentiation","parameters":[{"name":"pk","in":"path","required":true,"description":"Unique identifier of the attribute set.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Attribute set retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttributeSet"}}}},"404":{"description":"Attribute set not found"}}}}},"components":{"schemas":{"AttributeSet":{"type":"object","description":"Attribute set configuration defining product attribute schema.","required":["pk","variant_attributes","variant_listable_attributes"],"properties":{"pk":{"type":"integer","description":"Attribute set identifier"},"variant_attributes":{"type":"array","description":"List of attribute keys that define product variants.\n\nProducts with different values for these attributes are considered separate variants (e.g., size, color).","items":{"type":"string"}},"variant_listable_attributes":{"type":"array","description":"Subset of variant attributes shown in product listings.\n\nThese attributes help customers distinguish between variants in list views.","items":{"type":"string"}}}}}}}
```

## Retrieve attribute configuration groups

> Returns grouped attribute configurations for an attribute set.\
> \
> \*\*Attribute Config Groups:\*\*\
> Organizes product attributes into logical display groups for:\
> \* Product detail page attribute sections\
> \* Specification tables\
> \* Comparison matrices\
> \
> \*\*Group Structure:\*\*\
> Each group contains related attributes with their display configurations, ordering, and formatting rules.

```json
{"openapi":"3.1.0","info":{"title":"Product API - Product Catalog & Detail Information","version":"1.0.0"},"tags":[{"name":"Attribute","description":"Attribute sets and configuration groups"}],"servers":[{"description":"Commerce API Server","url":"https://{commerce_url}","variables":{"commerce_url":{"default":"sandbox.akinon.com","description":"Commerce server URL (e.g., your-store.akinon.com)"}}}],"paths":{"/attribute_set/{pk}/attribute_config_groups/":{"get":{"tags":["Attribute"],"operationId":"getAttributeConfigGroups","summary":"Retrieve attribute configuration groups","description":"Returns grouped attribute configurations for an attribute set.\n\n**Attribute Config Groups:**\nOrganizes product attributes into logical display groups for:\n* Product detail page attribute sections\n* Specification tables\n* Comparison matrices\n\n**Group Structure:**\nEach group contains related attributes with their display configurations, ordering, and formatting rules.","parameters":[{"name":"pk","in":"path","required":true,"description":"Unique identifier of the attribute set.","schema":{"type":"integer"}}],"responses":{"200":{"description":"Attribute configuration groups retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttributeConfigGroupResponse"}}}},"404":{"description":"Attribute set not found"}}}}},"components":{"schemas":{"AttributeConfigGroupResponse":{"type":"object","description":"Response containing grouped attribute configurations.","required":["attribute_config_groups"],"properties":{"attribute_config_groups":{"type":"array","description":"List of attribute groups with their configurations.\n\nEach group organizes related attributes for display purposes.","items":{"$ref":"#/components/schemas/AttributeConfigGroup"}}}},"AttributeConfigGroup":{"type":"object","description":"A logical grouping of product attributes for display.","properties":{"name":{"type":"string","description":"Display name of the attribute group."},"order":{"type":"integer","description":"Display order for the group."},"attributes":{"type":"array","description":"Attributes belonging to this group.","items":{"type":"object","properties":{"key":{"type":"string","description":"Attribute identifier"},"label":{"type":"string","description":"Display label"},"order":{"type":"integer","description":"Display order within group"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.akinon.com/commerce-openapis/products/attribute.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.