Update feature definitions

PUT

/v2/clients/{client_id}/domains/{domain_id}/features

curl --request PUT \
  --url https://pie.streamline.enterprises/v2/clients/client-1/domains/south_australia/features \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "features": [ { "name": "route", "json_schema": { "type": "string", "enum": [ "Adelaide to Sydney", "Sydney to Adelaide" ] }, "mandatory": true }, { "name": "competitor_count", "json_schema": { "type": "integer", "minimum": 0, "maximum": 20 }, "mandatory": false }, { "name": "weekly_demand", "json_schema": { "type": "array", "items": { "type": "number", "minimum": 0 }, "minItems": 7, "maxItems": 7 }, "mandatory": false }, { "name": "origin_destination_pair", "json_schema": { "type": "array", "prefixItems": [ { "type": "string" }, { "type": "string" } ], "items": false, "minItems": 2, "maxItems": 2 }, "mandatory": false }, { "name": "market_ref", "json_schema": { "oneOf": [ { "type": "string", "enum": [ "spot", "auction" ] }, { "type": "integer", "minimum": 0 } ] }, "mandatory": false } ] }'

• Production
• Staging
• Testing
• Local

Replaces all feature definitions for a domain. Services that were initialized using default values will be automatically re-initialized if the resolved features would change under the new definitions.

Authorizations

• BearerAuth

Parameters

Path Parameters

client_id

required

string

Example

client-1

domain_id

required

string

Example

south_australia

Request Body ^required

Media type application/json

object

features

required

Array<object>

object

name

required

string

Example

route

json_schema

required

JSON Schema Draft 2020-12 document for this feature’s value. Standard keywords apply; use default for the value applied when the caller omits this feature. Values are validated against this schema at service init/update. Arrays use type with items; fixed-length tuple shapes use prefixItems with items: false; unions use oneOf / anyOf as in the spec.

object

Example

{
  "type": "string",
  "enum": [
    "Adelaide to Sydney",
    "Sydney to Adelaide"
  ]
}

mandatory

required

boolean

Example

true

Example

{
  "name": "route",
  "json_schema": {
    "type": "string",
    "enum": [
      "Adelaide to Sydney",
      "Sydney to Adelaide"
    ]
  },
  "mandatory": true
}

Example

{
  "features": [
    {
      "name": "route",
      "json_schema": {
        "type": "string",
        "enum": [
          "Adelaide to Sydney",
          "Sydney to Adelaide"
        ]
      },
      "mandatory": true
    },
    {
      "name": "competitor_count",
      "json_schema": {
        "type": "integer",
        "minimum": 0,
        "maximum": 20
      },
      "mandatory": false
    },
    {
      "name": "weekly_demand",
      "json_schema": {
        "type": "array",
        "items": {
          "type": "number",
          "minimum": 0
        },
        "minItems": 7,
        "maxItems": 7
      },
      "mandatory": false
    },
    {
      "name": "origin_destination_pair",
      "json_schema": {
        "type": "array",
        "prefixItems": [
          {
            "type": "string"
          },
          {
            "type": "string"
          }
        ],
        "items": false,
        "minItems": 2,
        "maxItems": 2
      },
      "mandatory": false
    },
    {
      "name": "market_ref",
      "json_schema": {
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "spot",
              "auction"
            ]
          },
          {
            "type": "integer",
            "minimum": 0
          }
        ]
      },
      "mandatory": false
    }
  ]
}

Responses

200

Features updated; lists services being re-initialized

Media type application/json

object

features

required

Array<object>

object

name

required

string

json_schema

required

JSON Schema Draft 2020-12 document for this feature’s value. Standard keywords apply; use default for the value applied when the caller omits this feature. Values are validated against this schema at service init/update. Arrays use type with items; fixed-length tuple shapes use prefixItems with items: false; unions use oneOf / anyOf as in the spec.

object

mandatory

required

boolean

reinitializing_services

required

Service IDs that are being re-initialized due to resolved feature changes

Array<string>

unchanged_services

required

Service IDs unaffected by the feature update

Array<string>

Example

{
  "features": [
    {
      "name": "route",
      "json_schema": {
        "type": "string",
        "default": "Adelaide to Sydney"
      },
      "mandatory": true
    }
  ],
  "reinitializing_services": [
    "svc-abc"
  ],
  "unchanged_services": [
    "svc-xyz"
  ]
}

400

Validation error — malformed input, invalid path parameters, or request that fails syntactic validation.

Media type application/json

object

success

required

boolean

message

required

Human-readable error message

string

Example

{
  "success": false
}

401

Missing or invalid Authorization bearer token, expired token, or token rejected by the authorization layer (e.g. API Gateway JWT authorizer or application validation).

Media type application/json

object

success

required

boolean

message

required

Human-readable error message

string

Example

{
  "success": false
}

403

Authenticated caller lacks the permission required for this operation.

Media type application/json

object

success

required

boolean

message

required

Human-readable error message

string

Example

{
  "success": false
}

404

Requested resource was not found.

Media type application/json

object

success

required

boolean

message

required

Human-readable error message

string

Example

{
  "success": false
}

422

Semantically invalid request — e.g. domain not active, no model assigned, feature contract mismatch, or invalid feature definitions.

Media type application/json

object

success

required

boolean

message

required

Human-readable error message

string

Example

{
  "success": false
}