---
updatedAt: 2026-05-12T17:47:03.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.

# Update attribute group

Update the `values` field in an attribute group. All other attribute group fields are immutable.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Core platform - Flex controls",
    "version": "1.0.0",
    "description": "Flex controls API",
    "contact": {
      "name": "API Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io/rules",
      "description": "Sandbox API server for testing"
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Account access token. Tokens can expire quickly, which can result in an \"Unauthorized\" error.",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "AttributeGroupValues": {
        "type": "array",
        "description": "Attribute group values\n- Each value must be unique within the array\n- Maximum of 20,000 items\n- Each item must not exceed 15 characters\n",
        "maxLength": 25000,
        "minLength": 1,
        "items": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9]+$",
          "maxLength": 15,
          "minLength": 1
        },
        "example": [
          "0123",
          "2224",
          "3876"
        ]
      },
      "ErrorDetail": {
        "type": "object",
        "description": "Error detail.",
        "properties": {
          "location": {
            "type": "string",
            "example": "payload.entity_type",
            "description": "Identifies where the request is causing an error."
          },
          "message": {
            "type": "string",
            "description": "Description of error",
            "example": "`entity_type` should be `legal_person` or `natural_person`"
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "description": "Error response",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error description"
          },
          "error_code": {
            "type": "string",
            "description": "Error code ID",
            "deprecated": true
          },
          "code": {
            "description": "Error code ID",
            "type": "string"
          }
        }
      },
      "ErrorResponseWithDetails": {
        "type": "object",
        "description": "Error response",
        "properties": {
          "message": {
            "type": "string",
            "description": "Error description"
          },
          "details": {
            "type": "array",
            "description": "Provides more information about the error message.",
            "items": {
              "$ref": "#/components/schemas/ErrorDetail"
            }
          },
          "error_code": {
            "type": "string",
            "description": "Error code ID",
            "deprecated": true
          },
          "code": {
            "type": "string",
            "description": "Error code ID"
          }
        }
      }
    },
    "examples": {
      "ERUL0805": {
        "description": "Attribute group not found example",
        "value": {
          "message": "attribute group not found",
          "error_code": "RULVAL0400",
          "code": "ERUL0805"
        }
      },
      "ERUL0806": {
        "description": "Attribute group not found example",
        "value": {
          "message": "The 'value' field is the only one that can be updated.",
          "error_code": "RULVAL0400",
          "code": "ERUL0806"
        }
      }
    }
  },
  "tags": [
    {
      "name": "Attribute groups",
      "description": "API endpoints for managing attribute groups used in flex controls."
    }
  ],
  "paths": {
    "/v1/attribute-groups/{groupId}": {
      "patch": {
        "operationId": "update-v1-attribute-groups",
        "summary": "Update attribute group",
        "description": "Update the `values` field in an attribute group. All other attribute group fields are immutable.",
        "tags": [
          "Attribute groups"
        ],
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "groupId",
            "in": "path",
            "required": true,
            "description": "Attribute group ID",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "description": "Attribute group values to update",
                "type": "object",
                "properties": {
                  "values": {
                    "$ref": "#/components/schemas/AttributeGroupValues"
                  }
                },
                "required": [
                  "values"
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No content"
          },
          "400": {
            "description": "Bad request. Validation error on request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponseWithDetails"
                },
                "examples": {
                  "attribute group not found": {
                    "$ref": "#/components/examples/ERUL0806"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not found. The attribute group was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "attribute group not found": {
                    "$ref": "#/components/examples/ERUL0805"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```