Replace One

Replace One.

Collections hold your records. Norbix generates a full CRUD + query API over each collection from its schema, with record-level ownership and triggers. Replaces the one.

This method is on the runtime API surface (norbix.api.database) — call it from your app.

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.

JavaScript / TypeScript

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

const result = await norbix.api.database.replaceOne({
  collectionName: 'orders',
  id: 'rec_4kX9mQvR2tYw7ZbC1dFgHj',
  databaseIntegrationId: 'int_4kX9mQvR2tYw7ZbC1dFgHj',
  replacement: 'orders-v2',
});

.NET

using Norbix.Sdk;
using Norbix.Sdk.Types.Api;

using var client = new NorbixClient();

var result = await client.Database.ReplaceOneAsync(new ReplaceOneRequest
{
    CollectionName = "orders",
    Id = "rec_4kX9mQvR2tYw7ZbC1dFgHj",
    DatabaseIntegrationId = "int_4kX9mQvR2tYw7ZbC1dFgHj",
    Replacement = "orders-v2",
});

Python

from norbix_python import NorbixApi

norbix = NorbixApi()

result = norbix.database.replace_one(
    collectionName="orders",
    id="rec_4kX9mQvR2tYw7ZbC1dFgHj",
    databaseIntegrationId="int_4kX9mQvR2tYw7ZbC1dFgHj",
    replacement="orders-v2",
)

Go

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

var result map[string]any
err := c.API.Database.ReplaceOne(ctx, "orders", "rec_4kX9mQvR2tYw7ZbC1dFgHj", map[string]any{
	"databaseIntegrationId": "int_4kX9mQvR2tYw7ZbC1dFgHj",
	"replacement": "orders-v2",
}, &result)

Dart / Flutter

import 'package:norbix/norbix_api.dart';

final api = NorbixApi();

final result = await api.database.replaceOne(collectionName: 'orders', id: 'rec_4kX9mQvR2tYw7ZbC1dFgHj', body: {
  'databaseIntegrationId': 'int_4kX9mQvR2tYw7ZbC1dFgHj',
  'replacement': 'orders-v2',
});

Swift

import NorbixSwift

let client = Norbix()

let result = try await client.api.database.replaceOne([
    "collectionName": "orders",
    "id": "rec_4kX9mQvR2tYw7ZbC1dFgHj",
    "databaseIntegrationId": "int_4kX9mQvR2tYw7ZbC1dFgHj",
    "replacement": "orders-v2",
])

Kotlin

import dev.norbix.sdk.api.NorbixApi

val api = NorbixApi()

val result = api.database.replaceOne(mapOf(
    "collectionName" to "orders",
    "id" to "rec_4kX9mQvR2tYw7ZbC1dFgHj",
    "databaseIntegrationId" to "int_4kX9mQvR2tYw7ZbC1dFgHj",
    "replacement" to "orders-v2",
))

CLI

norbix db replace orders --id rec_4kX9mQvR2tYw7ZbC1dFgHj --doc '{"status":"active"}'

In the dashboard

Manage this visually in Norbix Cloud — see Database → Collections.

API reference

Full request and response for this endpoint: Replace One.