POST /setting/create
Create Setting
Create settings using composable infra architecture.
Request Body (CreateSettingApiRequest)
| Field | Type | Required | Description |
|---|---|---|---|
settings | CreateSettingItem[] | Yes | List of settings to create |
idempotency_key | string | No | Operation key for ack — promotes or rejects a dormant create |
soft | boolean | No | Stage the create dormant (active=False) — propose; the ack ({idempotency_key, accept}) promotes/rejects it |
accept | boolean | No | Accept (promote) or reject dormant state. Only meaningful with idempotency_key |
Response (CreateSettingApiResponse)
| Field | Type | Required | Description |
|---|---|---|---|
results | SettingResultItem[] | Yes | Per-item creation results |
settings | ListSettingApiSetting[] | No | Hydrated list rows for the newly-created settings. Mirrors the shape of /setting/search result rows so the client’s ghost rail can materialize the new card directly from the audit .completed payload — no follow-up refresh needed. |
idempotency_key | string | No | Idempotency key echoed back for client correlation |
Last updated on