Views

Create view

Create a view on a table. table_id may be a regular table id or a system-table keyword (contacts, chats, users); system tables are lazy-created on first interaction.

post/orgs/views

Request

  • Base URL: https://api.useinvent.com
  • URL: https://api.useinvent.com/orgs/views
  • Auth: HTTP bearer

Request body

idstring

Client-generated id for the new view (enables optimistic creation). Encoded (view_…) or raw UUID. Rejected if already in use.

table_idstring required
namestring

View name, e.g. "Pipeline".

descriptionstring

Short text about what the view shows.

color'red' | 'orange' | 'amber' | 'yellow' | 'lime' | 'green' | 'teal' | 'cyan' | 'sky' | 'blue' | 'indigo' | 'violet' | 'purple' | 'fuchsia' | 'pink' | 'rose' | 'neutral'

Accent color, by name

kind'table' | 'board' | 'calendar' | 'timeline' | 'list' | 'gallery' required

The view layout.

Response

idstring required
table_idstring required
table_type'custom' | 'contacts' | 'chats' | 'users' required
namestring nullable required
descriptionstring nullable required
color'red' | 'orange' | 'amber' | 'yellow' | 'lime' | 'green' | 'teal' | 'cyan' | 'sky' | 'blue' | 'indigo' | 'violet' | 'purple' | 'fuchsia' | 'pink' | 'rose' | 'neutral' required

Accent color, by name

kind'table' | 'board' | 'calendar' | 'timeline' | 'list' | 'gallery' required

The view layout.

positioninteger required
is_defaultboolean required
show_in_sidebarboolean required
archivedboolean required
created_atstring date-time nullable required
updated_atstring date-time nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.