---
title: "POST /attribute-groups"
method: POST
path: "/attribute-groups"
---

# POST /attribute-groups

`POST /attribute-groups`

Creates a new attribute group as a container for user-defined attributes. This feature enables users to have full control over their cloud application's metadata in a rich machine-readable format to facilitate integration with automated workflows and third-party tools.

## Request body

- object
  - `name` string, required — The name of the attribute group.
  - `description` string — The description of the attribute group that the user provides.
  - `attributes` string, required — A JSON string in the form of nested key-value pairs that represent the attributes in the group and describes an application and its components.
  - `tags` object — Key-value pairs you can use to associate with the attribute group.
  - `clientToken` string, required — A unique identifier that you provide to ensure idempotency. If you retry a request that completed successfully using the same client token and the same parameters, the retry succeeds without performing any further actions. If you retry a successful request using the same client token, but one or more of the parameters are different, the retry fails.

## Response `201`

Success

- CreateAttributeGroupResponse
  - `attributeGroup` object — Information about the attribute group.
    - `id` string — The globally unique attribute group identifier of the attribute group.
    - `arn` string — The Amazon resource name (ARN) that specifies the attribute group across services.
    - `name` string — The name of the attribute group.
    - `description` string — The description of the attribute group that the user provides.
    - `creationTime` string, date-time — The ISO-8601 formatted timestamp of the moment the attribute group was created.
    - `lastUpdateTime` string, date-time — The ISO-8601 formatted timestamp of the moment the attribute group was last updated. This time is the same as the creationTime for a newly created attribute group.
    - `tags` object — Key-value pairs you can use to associate with the attribute group.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — ConflictException
- `482` — ValidationException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/servicecatalog-appregistry.md) · [All operations](https://skmtc.net/aws/apis/servicecatalog-appregistry/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/servicecatalog-appregistry/versions/69ce5241c582/schema)