views

Create a view

Changed on Jul 30, 2026

Create a view, this can be against an internal or external table.

post/views

Request

Base URL
https://budibase.app/api/public/v1
URL
https://budibase.app/api/public/v1/views
Auth
API key in header x-budibase-api-key

Headers

x-budibase-app-idstring required

The ID of the app which this request is targeting.

Request body

namestring required

The name of the view.

tableIdstring required

The ID of the table this view is based on.

type'calculation'

The type of view - standard (empty value) or calculation.

primaryDisplaystring

A column used to display rows from this view - usually used when rendered in tables.

schemaobject required

Response

Returns the created view, including the ID which has been generated for it.

Changes

Jul 30, 20269c6f16fc652b Revision changes
- breaking
  the request property type changed from object to no type
- breaking
  added subschema #1 subschema #2 to the / response property oneOf list for the response status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  removed the required property // from the response with the status
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- info
  added subschema #1 subschema #2 to the request property oneOf list
Jun 15, 2026daddd12b5a2f Revision changes
- warning
  added the new notOneOf enum value to the ////// response property for the response status
- warning
  added the new notOneOf enum value to the //////// response property for the response status
- info
  added the new notOneOf enum value to the request property /////
- info
  added the new notOneOf enum value to the request property ///////

Operation history (7 revisions)