> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/sdks/database/schemas/update-database-schema-list-settings.md).

# Update Database Schema List Settings

Replaces a schema's records-list settings — columns, their order and the default sort.

Replaces the records-list display settings of one collection. This is a **full replace**, not a patch: read the current settings with [Get Database Schema List Settings](/codemash/sdks/database/schemas/get-database-schema-list-settings.md), change what you need and send the complete object back. The settings are not part of the schema's draft / publish cycle — they apply at once. `PUT /{version}/database/schemas/{Id}/list-settings` | Field | Meaning | | --- | --- | | `id` (required) | The schema id (`sch_…`). | | `settings` (required) | `{ columns: [{ field }], defaultSort: { field, order } }`, e.g. `{ "columns": [{"field":"title"}, {"field":"amount"}], "defaultSort": { "field": "amount", "order": -1 } }`. | Permission: `database:update` on the schema. AI tool: `update_database_schema_list_settings`.

This method is on the **Hub** surface (`norbix.hub.database`) — call it from admin tooling or IaC.

{% hint style="info" %}
These examples assume the SDK is installed and your credentials are set as environment variables — each client reads them automatically, so the constructors below take no arguments. See [Install a Norbix SDK](/codemash/sdks/install.md).
{% endhint %}

{% tabs %}
{% tab title="JavaScript / TypeScript" %}

```ts
import { Norbix } from '@norbix.ai/ts';
const norbix = new Norbix();

const result = await norbix.hub.database.updateDatabaseSchemaListSettings({
  id: 'sch_4kX9mQvR2tYw7ZbC1dFgHj',
  settings: ['item-1'],
});
```

{% endtab %}

{% tab title=".NET" %}

```csharp
using Norbix.Sdk;
using Norbix.Sdk.Types.Hub;

using var client = new NorbixClient();

var result = await client.Database.UpdateDatabaseSchemaListSettingsAsync(new UpdateDatabaseSchemaListSettingsRequest
{
    Id = "sch_4kX9mQvR2tYw7ZbC1dFgHj",
    Settings = new[] { "item-1" },
});
```

{% endtab %}

{% tab title="Python" %}

```python
from norbix_python import NorbixHub

norbix = NorbixHub()

result = norbix.database.update_database_schema_list_settings(
    id="sch_4kX9mQvR2tYw7ZbC1dFgHj",
    settings=["item-1"],
)
```

{% endtab %}

{% tab title="Go" %}

```go
c, _ := norbix.New(norbix.Options{})
ctx := context.Background()

var result map[string]any
err := c.Hub.Database.UpdateDatabaseSchemaListSettings(ctx, "sch_4kX9mQvR2tYw7ZbC1dFgHj", map[string]any{
	"settings": []string{"item-1"},
}, &result)
```

{% endtab %}

{% tab title="Dart / Flutter" %}

```dart
import 'package:norbix/norbix_hub.dart';

final hub = NorbixHub();

final result = await hub.database.updateDatabaseSchemaListSettings(id: 'sch_4kX9mQvR2tYw7ZbC1dFgHj', body: {
  'settings': ['item-1'],
});
```

{% endtab %}

{% tab title="Swift" %}

```swift
import NorbixHub

let client = try NorbixHubClient()

let result = try await client.database.updateDatabaseSchemaListSettings([
    "id": "sch_4kX9mQvR2tYw7ZbC1dFgHj",
    "settings": ["item-1"],
])
```

{% endtab %}

{% tab title="Kotlin" %}

```kotlin
import ai.norbix.sdk.hub.NorbixHub

val hub = NorbixHub()

val result = hub.database.updateDatabaseSchemaListSettings(mapOf(
    "id" to "sch_4kX9mQvR2tYw7ZbC1dFgHj",
    "settings" to listOf("item-1"),
))
```

{% endtab %}

{% tab title="CLI" %}

```sh
norbix raw '/{version}/database/schemas/sch_4kX9mQvR2tYw7ZbC1dFgHj/list-settings' -X PUT --body '{"settings":["item-1"]}'
```

{% endtab %}
{% endtabs %}

## In Cloud

Manage this visually in Cloud — see [Database → Schemas](/codemash/cloud/database/collections/create-schema.md).

## API reference

Full request and response for this endpoint: [Update Database Schema List Settings](/codemash/api-reference/database/schemas/update-database-schema-list-settings.md).