ProjectConfigurationField

namestringrequired

Possible values: Value must match regular expression ^[A-Za-z_][A-Za-z0-9_.-]{0,199}$

typestringrequired

Possible values: [string, number, boolean, json, file]

labelstring

descriptionstring

defaultValue

Native JSON default. Never store real secrets in source declarations.

requiredboolean

secretboolean

multipleboolean

String arrays for string fields; up to 32 server file references for file fields.

controlstring

ai-models is reserved for the STEAMHARNESS_AGENT_MODELS JSON field. Entries contain id, name, model and source. System entries use credentialId; third-party entries use apiKind, baseUrl and apiKey. Values are private unless explicitly included in publication.

Possible values: [text, textarea, select, radio, checkboxes, ai-models]

allowThirdPartyboolean

Only valid for ai-models. Set false in configuration.json to allow only system AI. Saves and imports cannot add third-party entries or relax the project's declared policy. Omitted or true allows both sources.

acceptstring[]

File fields only. Accepted MIME types or extensions. Files upload through POST /api/projects/{projectId}/configurations/files and values contain server metadata, never file bytes.

options object[]

Array [

valuestringrequired

labelstring

]

sharing object

publishboolean

Default value: true

includeValueboolean

Default value: false

editableboolean

Default value: true

paths object

JSON Pointer rules, inherited from the parent with more specific rules taking precedence. Excluding the whole field excludes every descendant.

property name* ConfigurationSharingRule

publishboolean

Default value: true

includeValueboolean

Default value: false

editableboolean

Default value: true

omittedPathsstring[]

Generated opaque deny hashes for omitted JSON paths, without private path names.

Possible values: Value must match regular expression ^[a-f0-9]{64}$

ProjectConfigurationField

{
  "name": "string",
  "type": "string",
  "label": "string",
  "description": "string",
  "required": true,
  "secret": true,
  "multiple": true,
  "control": "text",
  "allowThirdParty": true,
  "accept": [
    "string"
  ],
  "options": [
    {
      "value": "string",
      "label": "string"
    }
  ],
  "sharing": {
    "publish": true,
    "includeValue": false,
    "editable": true
  },
  "paths": {},
  "omittedPaths": [
    "string"
  ]
}