---
title: "Update a specification."
method: POST
path: "/specification/{specification}"
tags: ["Domain management"]
---

# Update a specification.

`POST /specification/{specification}`

## Path parameters

- `specification` string, required

## Request body

- UpdateSpecificationRequest — The data used to define the updates to make to a target specification.
  - `shortName` string — The specification's short name. Skip this if no update should be made.
  - `fullName` string — The specification's full name. Skip this if no update should be made.
  - `description` string — The specification's description. Skip this if no update should be made or provide as an empty string to remove the current value.
  - `reportMetadata` string — The specification's additional metadata for XML reports.
  - `hidden` boolean — Whether the specification should be hidden. Skip this if no update should be made.
  - `displayOrder` number — The specification's display order relative to other groups and specifications. Skip this if no update should be made or set to a negative value to remove the ordering altogether.
  - `group` string — The API key of the specification group within which to move the specification. Skip this if no update should be made or provide as an empty string to remove the specification from its current group.

## Response `200`

Specification updated.

## Other responses

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

## Changes

> 29 revisions in range; 1 could not be searched.

- **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/specification/:specification/post.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)