---
title: "Create a system property definition."
method: PUT
path: "/configure/system"
tags: ["Configuration"]
---

# Create a system property definition.

`PUT /configure/system`

## Request body

- SystemPropertyInfo — The data for the system property.
  - `key` string, required — The unique key used to identify the property.
  - `name` string — The property's name. If not set this will be the same as the property's key.
  - `description` string — The property's description.
  - `required` boolean — Whether the property must be set before executing test sessions.
  - `editableByUsers` boolean — Whether the property can be set by organisation users.
  - `inTests` boolean — Whether the property should be exposed to test sessions.
  - `inExports` boolean — Whether the property should be included in exports.
  - `hidden` boolean — Whether the property should be hidden from organisation users.
  - `allowedValues` AllowedPropertyValue[] — The list of allowed values for the property.
    - `value` string, required — The property value.
    - `label` string, required — The property's display label.
  - `displayOrder` number — The display order of the property when presented to users.
  - `dependsOn` string — The key of another property upon which this property's applicability depends on (see also dependsOnValue).
  - `dependsOnValue` string — If the dependsOn property is set, this is the value that the referred-to property needs to have for this property to be considered applicable.
  - `defaultValue` string — The default value of the property when a new system is created.

## Response `200`

Property created.

## 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-08-26** `548e0ed69312` — 1 warning
  - removed the request property `domain`
- **2024-08-26** `47017afa7060` — 1 info
  - removed the non-success response with the status `400`
- **2024-08-23** `f0eaf8c12964` — 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/configure/system/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)