Save Database Taxonomy

Creates or updates a database taxonomy.

A taxonomy is a hierarchical set of terms (categories, tags) you can attach to records. This method creates the database taxonomy and returns its id.

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

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.hub.database.saveDatabaseTaxonomy({
  taxonomyName: 'orders',
  viewId: 'view_4kX9mQvR2tYw7ZbC1dFgHj',
  description: 'Managed via the Norbix SDK.',
  termsMetaDataSchema: '{}',
});

.NET

using Norbix.Sdk;
using Norbix.Sdk.Types.Hub;

using var client = new NorbixClient();

var result = await client.Database.SaveDatabaseTaxonomyAsync(new SaveDatabaseTaxonomyRequest
{
    TaxonomyName = "orders",
    ViewId = "view_4kX9mQvR2tYw7ZbC1dFgHj",
    Description = "Managed via the Norbix SDK.",
    TermsMetaDataSchema = "{}",
});

Python

from norbix_python import NorbixHub

norbix = NorbixHub()

result = norbix.database.save_database_taxonomy(
    taxonomyName="orders",
    viewId="view_4kX9mQvR2tYw7ZbC1dFgHj",
    description="Managed via the Norbix SDK.",
    termsMetaDataSchema="{}",
)

Go

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

var result map[string]any
err := c.Hub.Database.SaveDatabaseTaxonomy(ctx, map[string]any{
	"taxonomyName": "orders",
	"viewId": "view_4kX9mQvR2tYw7ZbC1dFgHj",
	"description": "Managed via the Norbix SDK.",
	"termsMetaDataSchema": "{}",
}, &result)

Dart / Flutter

import 'package:norbix/norbix_hub.dart';

final hub = NorbixHub();

final result = await hub.database.saveDatabaseTaxonomy(body: {
  'taxonomyName': 'orders',
  'viewId': 'view_4kX9mQvR2tYw7ZbC1dFgHj',
  'description': 'Managed via the Norbix SDK.',
  'termsMetaDataSchema': '{}',
});

Swift

import NorbixSwift

let client = Norbix()

let result = try await client.hub.database.saveDatabaseTaxonomy([
    "taxonomyName": "orders",
    "viewId": "view_4kX9mQvR2tYw7ZbC1dFgHj",
    "description": "Managed via the Norbix SDK.",
    "termsMetaDataSchema": "{}",
])

Kotlin

import dev.norbix.sdk.hub.NorbixHub

val hub = NorbixHub()

val result = hub.database.saveDatabaseTaxonomy(mapOf(
    "taxonomyName" to "orders",
    "viewId" to "view_4kX9mQvR2tYw7ZbC1dFgHj",
    "description" to "Managed via the Norbix SDK.",
    "termsMetaDataSchema" to "{}",
))

CLI

norbix hub db taxonomy save --taxonomyName orders --viewId view_4kX9mQvR2tYw7ZbC1dFgHj --description 'Managed via the Norbix SDK.' --termsMetaDataSchema '{}'

In the dashboard

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

API reference

Full request and response for this endpoint: Save Database Taxonomy.