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

# Create a specification.

`PUT /specification`

## Request body

- CreateSpecificationRequest — The data used to create a new specification.
  - `shortName` string, required — The specification's short name.
  - `fullName` string, required — The specification's full name.
  - `description` string — The specification's description.
  - `reportMetadata` string — The specification's additional metadata for XML reports.
  - `hidden` boolean — Whether the specification should be hidden.
  - `displayOrder` number — The specification's display order relative to other groups and specifications.
  - `apiKey` string — The API key to set for the specification. If this key is already assigned, a new one will be generated.
  - `group` string — The API key of the specification group within which to create the specification. If not provided the specification will be created directly under the domain.
  - `domain` string — The API key of the domain within which to create the specification. 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 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-28** `892bc91b9b65` — 1 info
  - added the new optional request property `domain`
- **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/specification/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)