Skip to content
KismetKismetDevelopers
llms.txt

Update software configuration

View .md

PATCH /v1/developer/collections/{collection}/software/{module}/configuration

Operation ID: updateDeveloperSoftwareConfiguration

Installation-scoped custom software. Requires a server credential. Collection, application and TEST/LIVE environment come from the credential. Settings are revisioned; engagement is client-reported, not consent or booking authority. Canonical outcome attribution is currently unavailable. Browser components use their same-origin server boundary; never expose the server credential.

Contract status

Section titled “Contract status”
Field Value
Maturity beta
Required capability telemetry.configure
Freshness class authenticated-state
Quota cost 1

All operations require a Kismet Developer Bearer credential. Collection and resource authority is resolved from the credential’s installation grants; identifiers in the URL never grant access.

Request parameters

Section titled “Request parameters”
Name In Type Required Description
collection path string yes
module path string yes

Request body

Section titled “Request body”

The request body is JSON. The canonical schema is:

{
  "type": "object",
  "properties": {
    "expectedRevision": {
      "type": "integer",
      "minimum": 1
    },
    "enabled": {
      "type": "boolean"
    },
    "signedOutOnly": {
      "type": "boolean"
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9-]{0,63}$"
          },
          "weight": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "settings": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 100
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                }
              ]
            }
          }
        },
        "required": [
          "id",
          "weight",
          "settings"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 8
    }
  },
  "required": [
    "expectedRevision",
    "enabled",
    "signedOutOnly",
    "variants"
  ],
  "additionalProperties": false
}

Minimal example:

{
  "expectedRevision": 1,
  "enabled": true,
  "signedOutOnly": true,
  "variants": [
    {
      "id": "string",
      "weight": 0,
      "settings": {}
    }
  ]
}

cURL

Section titled “cURL”

Set KISMET_API_ORIGIN=https://api.ksmt.app and configure KISMET_DEVELOPER_API_KEY in your environment. Run server-credential requests from your backend, not browser code.

Terminal window
curl --request PATCH \
  "$KISMET_API_ORIGIN/v1/developer/collections/example-collection/software/{module}/configuration" \
  --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{"expectedRevision":1,"enabled":true,"signedOutOnly":true,"variants":[{"id":"string","weight":0,"settings":{}}]}'

Responses

Section titled “Responses”
Status Meaning
200 Success.
400 Invalid request parameters or body.
401 Missing, invalid, expired, or inappropriate credential/session.
403 Credential lacks the required grant/capability, or an origin/CSRF check failed.
404 The authorized resource was not found.
409 Request conflicts with the installation environment or current state.
429 Rate limit or quota exceeded; inspect response metadata before retrying.
503 A required Kismet dependency is temporarily unavailable.

200 response example

Section titled “200 response example”
{
  "revision": 2,
  "enabled": true,
  "signedOutOnly": true,
  "assignmentUnit": "session",
  "settingsSchema": {
    "eligiblePage": {
      "type": "integer",
      "label": "Eligible page",
      "minimum": 1,
      "maximum": 2
    }
  },
  "variants": [
    {
      "id": "first-page",
      "label": "First page",
      "weight": 5000,
      "settings": {
        "eligiblePage": 1
      }
    },
    {
      "id": "second-page",
      "label": "Second page",
      "weight": 5000,
      "settings": {
        "eligiblePage": 2
      }
    }
  ],
  "actions": [
    {
      "id": "claim",
      "label": "Claim selected"
    }
  ],
  "updatedAt": "2026-09-01T00:00:00.000Z"
}

200 response schema

Section titled “200 response schema”

Content type: application/json. Required fields, nullable values, and nested structures are defined below.

View complete response schema 
{
  "type": "object",
  "properties": {
    "revision": {
      "type": "integer",
      "minimum": 1
    },
    "enabled": {
      "type": "boolean"
    },
    "signedOutOnly": {
      "type": "boolean"
    },
    "assignmentUnit": {
      "type": "string",
      "enum": [
        "session"
      ]
    },
    "settingsSchema": {
      "type": "object",
      "additionalProperties": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "boolean"
                ]
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              }
            },
            "required": [
              "type",
              "label"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "integer"
                ]
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "minimum": {
                "type": "integer"
              },
              "maximum": {
                "type": "integer"
              }
            },
            "required": [
              "type",
              "label",
              "minimum",
              "maximum"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "enum"
                ]
              },
              "label": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "values": {
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                "minItems": 1,
                "maxItems": 20
              }
            },
            "required": [
              "type",
              "label",
              "values"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9-]{0,63}$"
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160
          },
          "weight": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "settings": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 100
                },
                {
                  "type": "number"
                },
                {
                  "type": "boolean"
                }
              ]
            }
          }
        },
        "required": [
          "id",
          "label",
          "weight",
          "settings"
        ],
        "additionalProperties": false
      }
    },
    "actions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9-]{0,63}$"
          },
          "label": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "label"
        ],
        "additionalProperties": false
      }
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [
    "revision",
    "enabled",
    "signedOutOnly",
    "assignmentUnit",
    "settingsSchema",
    "variants",
    "actions",
    "updatedAt"
  ],
  "additionalProperties": false
}

Machine-readable sources

Section titled “Machine-readable sources”