Update a View

Update a view. Updates create a new version.

The previous version remains addressable and immutable. The new configuration is fully replacing — pass the complete view body, not a patch. The version number is auto-incremented.

Authorization

API Key

x-api-key<token>

Authenticate using API Key in request header

In: header

Path Parameters

view_id*string

Unique identifier of the view to update.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Name of the view

description?string

Description of the view

columns*array<>

List of columns in the view

filters*array<>

List of filters applied to the view

aggregations*array<>

List of aggregations defined for the view

functions*array<>

List of functions that this view queries transformations from

Response Body

`application/json`

curl -X PUT "https://api.bem.ai/v3/views/string" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "columns": [      {        "name": "string",        "valueSchemaPath": [          "string"        ],        "displayOrderIndex": 0      }    ],    "filters": [      {        "columnName": "string",        "filterType": "equals_string"      }    ],    "aggregations": [      {        "name": "string",        "function": "count"      }    ],    "functions": [      {}    ]  }'

{
  "viewID": "string",
  "name": "string",
  "description": "string",
  "currentVersionNum": 0,
  "columns": [
    {
      "name": "string",
      "valueSchemaPath": [
        "string"
      ],
      "displayOrderIndex": 0
    }
  ],
  "filters": [
    {
      "columnName": "string",
      "filterType": "equals_string",
      "string": "string",
      "number": 0.1
    }
  ],
  "aggregations": [
    {
      "name": "string",
      "function": "count",
      "aggregateColumnName": "string",
      "groupByColumnName": "string",
      "displayType": "table"
    }
  ],
  "functions": [
    {
      "id": "string",
      "name": "string"
    }
  ]
}