What parameters does POST /V1/products/attributes/:attributeCode/options accept?

This endpoint accepts 2 parameters: attributeCode (string) required; option (Magento\Eav\Api\Data\AttributeOptionInterface) required.

MageSmith

POSTCatalog · Magento 2.4.9 Admin · Magento_Catalog::attributes_attributes

POST /V1/products/attributes/:attributeCode/options

Q: What does the POST /V1/products/attributes/:attributeCode/options endpoint do in Magento 2?

POST /V1/products/attributes/:attributeCode/options is a Magento 2 REST endpoint in the Catalog module. Add option to attribute. Requires an admin Bearer token with ACL Magento_Catalog::attributes_attributes.

Q: Does POST /V1/products/attributes/:attributeCode/options require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_Catalog::attributes_attributes.

POST /V1/products/attributes/:attributeCode/options is a Magento 2 REST endpoint in the Catalog module. Add option to attribute. Requires an admin Bearer token with ACL Magento_Catalog::attributes_attributes.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

string

Service contract

Magento\Catalog\Api\ProductAttributeOptionManagementInterface::add

Authorization

Admin Bearer token with ACL:

Magento_Catalog::attributes_attributes

Path parameters

attributeCode string Required

Body parameters

option Magento\Eav\Api\Data\AttributeOptionInterface Required

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_Catalog::attributes_attributes

Path

/V1/products/attributes/{attributeCode}/options

Body

{
  "option": {
    "is_default": false,
    "label": "",
    "sort_order": 0,
    "store_labels": [
      {
        "label": "",
        "store_id": 0
      }
    ],
    "value": ""
  }
}