curl --request PUT \
  --url https://api.usedatabrain.com/api/v2/data-app/datamarts/semantic-layer \
  --header 'Authorization: Bearer dbn_live_abc123...' \
  --header 'Content-Type: application/json' \
  --data '{
    "datamartName": "sales-analytics",
    "tables": [
      {
        "name": "orders",
        "description": "Updated: Customer purchase orders with status tracking",
        "columns": [
          {
            "name": "status",
            "description": "Order lifecycle status",
            "synonyms": ["order status", "state", "order state"]
          }
        ]
      }
    ],
    "feedback": "Updated context: All amounts in USD. Fiscal year starts April 1."
  }'

curl --request PUT \
  --url https://api.usedatabrain.com/api/v2/data-app/datamarts/semantic-layer \
  --header 'Authorization: Bearer dbn_live_abc123...' \
  --header 'Content-Type: application/json' \
  --data '{
    "datamartName": "sales-analytics",
    "feedback": "Updated: All amounts in USD. Customer IDs are numeric."
  }'

const response = await fetch('https://api.usedatabrain.com/api/v2/data-app/datamarts/semantic-layer', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer dbn_live_abc123...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    datamartName: 'sales-analytics',
    tables: [
      {
        name: 'orders',
        description: 'Updated order descriptions',
        columns: [
          {
            name: 'status',
            description: 'Order lifecycle status',
            synonyms: ['order status', 'state']
          }
        ]
      }
    ],
    feedback: 'Updated feedback text.'
  })
});

const result = await response.json();

if (result.error) {
  console.error('Update failed:', result.error.message);
} else {
  console.log('Semantic layer updated:', result.id);
}

import requests

response = requests.put(
    'https://api.usedatabrain.com/api/v2/data-app/datamarts/semantic-layer',
    headers={
        'Authorization': 'Bearer dbn_live_abc123...',
        'Content-Type': 'application/json'
    },
    json={
        'datamartName': 'sales-analytics',
        'tables': [
            {
                'name': 'orders',
                'description': 'Updated order descriptions',
                'columns': [
                    {
                        'name': 'status',
                        'description': 'Order lifecycle status',
                        'synonyms': ['order status', 'state']
                    }
                ]
            }
        ],
        'feedback': 'Updated feedback text.'
    }
)

result = response.json()

if result.get('error'):
    print(f"Update failed: {result['error']['message']}")
else:
    print(f"Semantic layer updated: {result['id']}")

require 'net/http'
require 'json'

uri = URI('https://api.usedatabrain.com/api/v2/data-app/datamarts/semantic-layer')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Put.new(uri)
request['Authorization'] = 'Bearer dbn_live_abc123...'
request['Content-Type'] = 'application/json'
request.body = {
  datamartName: 'sales-analytics',
  tables: [
    {
      name: 'orders',
      description: 'Updated order descriptions',
      columns: [
        { name: 'status', description: 'Order lifecycle status' }
      ]
    }
  ]
}.to_json

response = http.request(request)
result = JSON.parse(response.body)
puts "Updated: #{result['id']}"

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class UpdateSemanticLayer {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();

        String requestBody = """
            {
                "datamartName": "sales-analytics",
                "tables": [
                    {
                        "name": "orders",
                        "description": "Updated order descriptions",
                        "columns": [
                            {
                                "name": "status",
                                "description": "Order lifecycle status"
                            }
                        ]
                    }
                ],
                "feedback": "Updated feedback text."
            }""";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.usedatabrain.com/api/v2/data-app/datamarts/semantic-layer"))
            .header("Authorization", "Bearer dbn_live_abc123...")
            .header("Content-Type", "application/json")
            .PUT(HttpRequest.BodyPublishers.ofString(requestBody))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    body := map[string]interface{}{
        "datamartName": "sales-analytics",
        "tables": []map[string]interface{}{
            {
                "name":        "orders",
                "description": "Updated order descriptions",
                "columns": []map[string]interface{}{
                    {
                        "name":        "status",
                        "description": "Order lifecycle status",
                    },
                },
            },
        },
        "feedback": "Updated feedback text.",
    }

    jsonData, _ := json.Marshal(body)

    req, _ := http.NewRequest("PUT",
        "https://api.usedatabrain.com/api/v2/data-app/datamarts/semantic-layer",
        bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer dbn_live_abc123...")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    fmt.Println("Semantic layer updated")
}

<?php
$url = 'https://api.usedatabrain.com/api/v2/data-app/datamarts/semantic-layer';
$data = [
    'datamartName' => 'sales-analytics',
    'tables' => [
        [
            'name' => 'orders',
            'description' => 'Updated order descriptions',
            'columns' => [
                [
                    'name' => 'status',
                    'description' => 'Order lifecycle status'
                ]
            ]
        ]
    ],
    'feedback' => 'Updated feedback text.'
];

$options = [
    'http' => [
        'header' => [
            'Authorization: Bearer dbn_live_abc123...',
            'Content-Type: application/json'
        ],
        'method' => 'PUT',
        'content' => json_encode($data)
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$result = json_decode($response, true);

echo "Updated: " . $result['id'];
?>

{
  "id": "sales-analytics"
}

{
  "error": {
    "code": "INVALID_REQUEST_BODY",
    "message": "\"datamartName\" is required"
  }
}

{
  "error": {
    "code": "INVALID_REQUEST_BODY",
    "message": "\"value\" must contain at least one of [tables, feedback]"
  }
}

{
  "error": {
    "code": "INVALID_TABLE",
    "message": "Table 'nonexistent_table' not found in datamart 'sales-analytics'"
  }
}

{
  "error": {
    "code": "SEMANTIC_LAYER_NOT_FOUND",
    "message": "No semantic layer found for datamart 'sales-analytics'. Use POST to create first."
  }
}

{
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Semantic Layer API requires a service token, not a data app API token"
  }
}