---
title: "Create a specification group."
method: PUT
path: "/group"
tags: ["Domain management"]
---

# Create a specification group.

`PUT /group`

## Request body

- CreateSpecificationGroupRequest — The data used to create a new specification group.
  - `shortName` string, required — The group's short name.
  - `fullName` string, required — The group's full name.
  - `description` string — The group's description.
  - `reportMetadata` string — The group's additional metadata for XML reports.
  - `displayOrder` number — The group's display order relative to other groups and specifications.
  - `apiKey` string — The API key to set for the group. If this key is already assigned, a new one will be generated.
  - `domain` string — The API key of the domain within which to create the group. This can be omitted if the community identified by the community API key used for authorisation is linked to a specific domain.

## Response `200`

Specification group created.

- ApiKeyResponse — The API key that was assigned to the creation of a new element.
  - `apiKey` string, required — The API key value.

## Other responses

- `429` — Call rate limit threshold exceeded for this operation.
- `default` — The received request was invalid.

## Changes

- **2026-03-19** `7637660a4a6b` — 1 info
  - added the non-success response with the status `429`
- **2024-09-26** `971d5a45d129` — 1 info
  - added the new optional request property `reportMetadata`
- **2024-08-26** `47017afa7060` — 1 info
  - endpoint added
- **2022-06-27** `06f633c06bcd` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/changes/group/put.md)

---

[API](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api.md) · [All operations](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ec-jrc/interoperability-test-bed-rest-api/revisions/433b3c0ae6d4/schema)