--- title: "Reorder this table's tab strip" method: PATCH path: "/orgs/tables/{table_id}/views/positions" tags: ["Tables"] --- # Reorder this table's tab strip `PATCH /orgs/tables/{table_id}/views/positions` ## Request - Base URL: `https://api.useinvent.com` - URL: `https://api.useinvent.com/orgs/tables/{table_id}/views/positions` - Auth: HTTP bearer Bulk-update the position of multiple views on one table in one transaction. ## Path parameters - `table_id` string, required ## Query parameters - `page` number - `take` number - `next` string - `progressive` boolean ## Request body - ReorderTableViewsSchema - `positions` object[], required: New positions for the views. - `id` string, required - `position` integer, required: New position for the view. ## Response `200` - TableViewSchema[] - `id` string, required - `table_id` string, required - `table_type` 'custom' | 'contacts' | 'chats' | 'users', required - `name` string, nullable, required - `description` string, 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 - `icon` union, required - string, emoji: The emoji of a curated icon a user can pick for a table, view, field, or other entity - 'TableCellsIcon' | 'DatabaseIcon' | 'DocumentTextIcon' | 'DocumentChartBarIcon' | 'ClipboardDocumentListIcon' | 'ClipboardDocumentCheckIcon' | 'FolderIcon' | 'ArchiveBoxIcon' | 'InboxIcon' | 'BookOpenIcon' | 'BookmarkIcon' | 'NewspaperIcon' | 'RectangleStackIcon' | 'PencilSquareIcon' | 'UserIcon' | 'UsersIcon' | 'UserGroupIcon' | 'UserPlusIcon' | 'IdentificationIcon' | 'FaceSmileIcon' | 'HandThumbUpIcon' | 'HeartIcon' | 'StarIcon' | 'CheckBadgeIcon' | 'TrophyIcon' | 'CrownIcon' | 'ChatBubbleLeftIcon' | 'ChatBubbleLeftRightIcon' | 'EnvelopeIcon' | 'EnvelopeOpenIcon' | 'PhoneIcon' | 'DevicePhoneMobileIcon' | 'MegaphoneIcon' | 'BellIcon' | 'PaperAirplaneIcon' | 'AtSymbolIcon' | 'RssIcon' | 'LifebuoyIcon' | 'ShoppingCartIcon' | 'ShoppingBagIcon' | 'BuildingStorefrontIcon' | 'CreditCardIcon' | 'BanknotesIcon' | 'CurrencyDollarIcon' | 'CurrencyEuroIcon' | 'ReceiptPercentIcon' | 'WalletIcon' | 'CoinsIcon' | 'GiftIcon' | 'TagIcon' | 'TicketIcon' | 'ScaleIcon' | 'TruckIcon' | 'CubeIcon' | 'CalendarIcon' | 'CalendarDaysIcon' | 'CalendarDateRangeIcon' | 'ClockIcon' | 'FlagIcon' | 'CheckCircleIcon' | 'ListBulletIcon' | 'QueueListIcon' | 'FunnelIcon' | 'ChartBarIcon' | 'ChartPieIcon' | 'PresentationChartLineIcon' | 'ArrowTrendingUpIcon' | 'BriefcaseIcon' | 'WrenchScrewdriverIcon' | 'Cog6ToothIcon' | 'KeyIcon' | 'LockClosedIcon' | 'ShieldCheckIcon' | 'BoltIcon' | 'LightBulbIcon' | 'BeakerIcon' | 'BugAntIcon' | 'CpuChipIcon' | 'CodeBracketIcon' | 'CommandLineIcon' | 'ServerIcon' | 'LinkIcon' | 'HomeIcon' | 'HomeModernIcon' | 'BuildingOfficeIcon' | 'BuildingOffice2Icon' | 'BuildingLibraryIcon' | 'MapPinIcon' | 'MapIcon' | 'GlobeAltIcon' | 'GlobeAmericasIcon' | 'RocketLaunchIcon' | 'PlaneIcon' | 'CarIcon' | 'SunIcon' | 'MoonIcon' | 'FireIcon' | 'SparklesIcon' | 'CakeIcon' | 'AcademicCapIcon' | 'ScissorsIcon' | 'SwatchIcon' | 'PaintBrushIcon' | 'CoffeeIcon' | 'UtensilsIcon' | 'LeafIcon' | 'DumbbellIcon' | 'HeartPulseIcon' | 'PawPrintIcon' | 'StethoscopeIcon' | 'CameraIcon' | 'PhotoIcon' | 'FilmIcon' | 'VideoCameraIcon' | 'MicrophoneIcon' | 'MusicalNoteIcon' | 'SpeakerWaveIcon' | 'PlayCircleIcon' | 'TvIcon' | 'RadioIcon' | 'PuzzlePieceIcon' | 'GamepadIcon': The name of a curated icon a user can pick for a table, view, field, or other entity - `kind` 'table' | 'board' | 'calendar' | 'timeline' | 'list' | 'gallery', required: The view layout. - `config` TableViewConfigSchema, required - `shared` TableViewSharedConfigSchema: Settings that apply to every view layout. - `open_items_in` 'side_peek' | 'center_peek' | 'full_page': Where clicking a record opens it. - `board` TableViewBoardConfigSchema: Settings for board views. - `field_id` string: Group-by field id. - `hide_empty_groups` boolean: Whether groups with no records are hidden. - `card_fields` string[]: Field ids shown on each card. Array order is display order. - `columns` TableViewBoardColumnSchema[]: Group order and visibility. Only honored for enum, user, boolean, string and number group-by fields. - `key` string, required: Key of the group, such as an option value. - `visible` boolean, required: Whether the group shows on the board. - `date` TableViewBoardDateConfigSchema: Date / datetime group-by only. - `granularity` 'relative' | 'day' | 'week' | 'month' | 'year': Granularity for the date buckets. - `sort` 'oldest_first' | 'newest_first': Sort order for the date buckets. - `number` TableViewBoardNumberConfigSchema: Number group-by only: buckets of `step` across [from, to). - `from` number: Where the first number group starts. - `to` number: Where the last number group ends (not included). - `step` number: How wide each number group is. - `sort` 'asc' | 'desc': Order of the number groups. - `card_color` 'none' | 'bordered' | 'background': How cards pick up their group color (enum group-by). - `table` TableViewTableConfigSchema: Settings for table views. - `columns` TableViewTableColumnSchema[]: Column order, visibility and width. Array order is column order. - `field_id` string, required: Id of the field this column shows. - `visible` boolean, required: Whether the column shows in the table. - `sticky` boolean, required: Whether the column stays in view while scrolling sideways. - `wrap` boolean: Whether long text in the column wraps onto more lines. - `width` integer: Pixel width. Omit for auto. - `calendar` TableViewCalendarConfigSchema: Settings for calendar views. - `field_id` string: Date field id. - `show_as` 'month' | 'week': Month matrix or single week with time rows. - `show_weekends` boolean: Whether Saturday and Sunday show on the calendar. - `timeline` TableViewTimelineConfigSchema: Settings for timeline views. - `field_id` string: Date field id. - `show_as` 'hours' | 'day' | 'week' | 'bi_week' | 'month' | 'quarter' | 'year' | 'five_years': Zoom preset: the span one timeline page covers. - `card_fields` string[]: Field ids shown on each bar. Array order is display order. - `list` TableViewListConfigSchema: Settings for list views. - `fields` string[]: Field ids shown inline on each row. Array order is display order. - `gallery` TableViewGalleryConfigSchema: Settings for gallery views. - `cover_field_id` string: File field id used as the card cover. - `fit` 'cover' | 'contain': How the cover fills the card frame. - `size` 'small' | 'medium' | 'large': Card size, mapped to grid cell dimensions on the FE. - `card_fields` string[]: Field ids shown on each card. Array order is display order. - `sort` TableViewSortSchema, nullable, required - `field_id` string, required - `direction` 'asc' | 'desc', required - `filter` union, required - FilterRuleSchema - `type` 'rule', required - `field_id` string, required - `operator` 'contains' | 'not_contains' | 'eq' | 'neq' | 'gt' | 'lt' | 'gte' | 'lte' | 'before' | 'after' | 'on_or_before' | 'on_or_after' | 'in' | 'not_in' | 'is_empty' | 'is_not_empty', required - `value` unknown - FilterGroupSchema - `type` 'group', required - `combinator` 'and' | 'or', required - `children` FilterSchema[], required - union - FilterRuleSchema - `type` 'rule', required - `field_id` string, required - `operator` 'contains' | 'not_contains' | 'eq' | 'neq' | 'gt' | 'lt' | 'gte' | 'lte' | 'before' | 'after' | 'on_or_before' | 'on_or_after' | 'in' | 'not_in' | 'is_empty' | 'is_not_empty', required - `value` unknown - FilterGroupSchema (recursive) - `position` integer, required - `is_default` boolean, required - `show_in_sidebar` boolean, required - `archived` boolean, required - `created_at` string, date-time, nullable, required - `updated_at` string, date-time, nullable, required --- [API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)