> ## Documentation Index > Fetch the complete documentation index at: https://docs.useinvent.com/llms.txt > Use this file to discover all available pages before exploring further. # List groups (columns) for a view > Returns the board column descriptors (enum items, boolean buckets, date / number ranges, distinct strings) plus capability flags — `reorderable_columns` enables column-header DnD, `movable_items` enables card DnD between columns (only meaningful for enum / user / boolean axes), `axis` carries the resolved field for the FE header. No pagination — bounded by `MAX_BOARD_COLUMNS`. Throws 400 for kinds that have no groups (table / calendar / timeline). ## OpenAPI ````yaml https://api.useinvent.com/openapi.json get /orgs/{org_id}/views/{view_id}/groups openapi: 3.1.0 info: version: 1.0.0 title: Invent API servers: - url: https://api.useinvent.com security: - bearerAuth: [] paths: /orgs/{org_id}/views/{view_id}/groups: get: tags: - Orgs Views summary: List groups (columns) for a view description: >- Returns the board column descriptors (enum items, boolean buckets, date / number ranges, distinct strings) plus capability flags — `reorderable_columns` enables column-header DnD, `movable_items` enables card DnD between columns (only meaningful for enum / user / boolean axes), `axis` carries the resolved field for the FE header. No pagination — bounded by `MAX_BOARD_COLUMNS`. Throws 400 for kinds that have no groups (table / calendar / timeline). parameters: - schema: type: string required: true description: Org ID name: org_id in: path - schema: type: string required: true description: View ID name: view_id in: path responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/TableViewGroupsResponseSchema' components: schemas: TableViewGroupsResponseSchema: type: object properties: groups: type: array items: $ref: '#/components/schemas/TableViewGroupSchema' capabilities: $ref: '#/components/schemas/TableViewGroupsCapabilitiesSchema' required: - groups - capabilities TableViewGroupSchema: oneOf: - type: object properties: key: type: string type: type: string enum: - unmatched required: - key - type - type: object properties: key: type: string type: type: string enum: - enum enum: $ref: '#/components/schemas/FieldEnumItemSchema' required: - key - type - enum - type: object properties: key: type: string type: type: string enum: - user user: $ref: '#/components/schemas/UserPublicSchema' required: - key - type - user - type: object properties: key: type: string type: type: string enum: - date_relative date_relative: $ref: '#/components/schemas/TableViewGroupDateRelativeSchema' required: - key - type - date_relative - type: object properties: key: type: string type: type: string enum: - date_granular date_granular: $ref: '#/components/schemas/TableViewGroupDateGranularSchema' required: - key - type - date_granular - type: object properties: key: type: string type: type: string enum: - number number: $ref: '#/components/schemas/TableViewGroupNumberSchema' required: - key - type - number - type: object properties: key: type: string type: type: string enum: - boolean boolean: $ref: '#/components/schemas/TableViewGroupBooleanSchema' required: - key - type - boolean - type: object properties: key: type: string type: type: string enum: - string string: $ref: '#/components/schemas/TableViewGroupStringSchema' required: - key - type - string TableViewGroupsCapabilitiesSchema: type: object properties: reorderable_columns: type: boolean movable_items: type: boolean axis: $ref: '#/components/schemas/ViewFieldSchema' required: - reorderable_columns - movable_items - axis FieldEnumItemSchema: type: object properties: label: type: string description: Label of the enum item value: type: string description: Value of the enum item description: type: string description: Description of the enum item color: $ref: '#/components/schemas/ColorNameSchema' icon: type: string maxLength: 64 pattern: ^[a-zA-Z0-9_-]+$ description: The name of the icon to use in the UI oneOf: - $ref: '#/components/schemas/IconNameSchema' icon_url: type: string metadata: $ref: '#/components/schemas/FieldEnumItemMetadataSchema' required: - value description: The enum item UserPublicSchema: type: object properties: id: type: string name: type: - string - 'null' avatar: type: - string - 'null' required: - id - name - avatar description: User who deployed the version TableViewGroupDateRelativeSchema: type: object properties: token: type: string enum: - future - today - yesterday - last_7_days - last_30_days - this_month - last_month - older required: - token TableViewGroupDateGranularSchema: type: object properties: date: type: string granularity: type: string enum: - relative - day - week - month - year required: - date - granularity TableViewGroupNumberSchema: type: object properties: from: type: number to: type: number required: - from - to TableViewGroupBooleanSchema: type: object properties: value: type: boolean required: - value TableViewGroupStringSchema: type: object properties: value: type: string required: - value ViewFieldSchema: oneOf: - $ref: '#/components/schemas/ViewScalarFieldSchema' - $ref: '#/components/schemas/ViewRefOneFieldSchema' discriminator: propertyName: kind mapping: scalar: $ref: '#/components/schemas/ViewScalarFieldSchema' ref-1: $ref: '#/components/schemas/ViewRefOneFieldSchema' ColorNameSchema: type: string enum: - red - orange - amber - yellow - lime - green - teal - cyan - sky - blue - indigo - violet - purple - fuchsia - pink - rose - neutral description: The name of the color to use in the UI IconNameSchema: type: string enum: - StepFormIcon - StepAiIcon - StepNoteIcon - StepBranchIcon - StepCodeIcon - ConnectionIcon - ConnectionSchedulerIcon - ConnectionFilesIcon - ConnectionHttpIcon - ConnectionWorkflowIcon - ConnectionMcpIcon - ConnectionAudienceIcon - ConnectionTablesIcon - ConnectionAssistantsIcon - ConnectionInboxIcon - ConnectionKnowledgeIcon - ConnectionAuditIcon - InternalIntegrationIcon - CustomIntegrationIcon - ToolThinkIcon - ToolWebSearchIcon - ToolWebScrapingIcon - ToolGenerateImageIcon - ToolDisplayFileIcon - ToolCalculatorIcon - ToolGenerateFileIcon - ToolGeneratePdfIcon - ToolRunCodeIcon - ToolDeepResearchIcon - ToolSearchKbIcon - ToolShowOptionsIcon - ToolRequestLocationIcon - ToolSendLocationIcon - ToolManageMemoryIcon - ToolUpdateContactIcon - TextIcon - ClockFadingIcon - CalendarIcon - CloudIcon - GlobeAltIcon - LockClosedIcon - NoSymbolIcon - SparklesIcon - AcademicCapIcon - HandRaisedIcon - BoltIcon - FileSpreadsheetIcon - DatabaseIcon - TableIcon - TableRowIcon - TableRowAddIcon - TableRowEditIcon - TableRowDeleteIcon - TableRowsIcon - PageIcon - UserIcon - UsersIcon - EmailIcon - PhoneIcon - CurrencyIcon - FunctionIcon - TableCellsIcon - DocumentTextIcon - QueueListIcon - TagIcon - SettingsIcon - ShoppingCartIcon - ShoppingBagIcon - BuildingStorefrontIcon - MegaphoneIcon - WrenchScrewdriverIcon - DocumentChartBarIcon - ClipboardDocumentListIcon - ClipboardDocumentCheckIcon - FolderIcon - ArchiveBoxIcon - InboxIcon - BookOpenIcon - BookmarkIcon - NewspaperIcon - RectangleStackIcon - PencilSquareIcon - UserGroupIcon - UserPlusIcon - IdentificationIcon - FaceSmileIcon - HandThumbUpIcon - HeartIcon - StarIcon - CheckBadgeIcon - TrophyIcon - CrownIcon - ChatBubbleLeftIcon - ChatBubbleLeftRightIcon - EnvelopeIcon - EnvelopeOpenIcon - DevicePhoneMobileIcon - BellIcon - PaperAirplaneIcon - AtSymbolIcon - RssIcon - LifebuoyIcon - CreditCardIcon - BanknotesIcon - CurrencyDollarIcon - CurrencyEuroIcon - ReceiptPercentIcon - WalletIcon - CoinsIcon - GiftIcon - TicketIcon - ScaleIcon - TruckIcon - CubeIcon - CalendarDaysIcon - CalendarDateRangeIcon - ClockIcon - FlagIcon - CheckCircleIcon - ListBulletIcon - FunnelIcon - ChartBarIcon - ChartPieIcon - PresentationChartLineIcon - ArrowTrendingUpIcon - BriefcaseIcon - Cog6ToothIcon - KeyIcon - ShieldCheckIcon - LightBulbIcon - BeakerIcon - BugAntIcon - CpuChipIcon - CodeBracketIcon - CommandLineIcon - ServerIcon - LinkIcon - HomeIcon - HomeModernIcon - BuildingOfficeIcon - BuildingOffice2Icon - BuildingLibraryIcon - MapPinIcon - MapIcon - GlobeAmericasIcon - RocketLaunchIcon - PlaneIcon - CarIcon - SunIcon - MoonIcon - FireIcon - CakeIcon - ScissorsIcon - SwatchIcon - PaintBrushIcon - CoffeeIcon - UtensilsIcon - LeafIcon - DumbbellIcon - HeartPulseIcon - PawPrintIcon - StethoscopeIcon - CameraIcon - PhotoIcon - FilmIcon - VideoCameraIcon - MicrophoneIcon - MusicalNoteIcon - SpeakerWaveIcon - PlayCircleIcon - TvIcon - RadioIcon - PuzzlePieceIcon - GamepadIcon - ModelAutoIcon - ModelOpenAIIcon - ModelAnthropicIcon - ModelClaudeIcon - ModelGoogleIcon - ModelXAIIcon - ModelGrokIcon - ModelPerplexityIcon - ModelGroqIcon - ModelAzureIcon - ModelElevenLabsIcon - ModelDeepgramIcon - ModelOpenRouterIcon - ModelDeepSeekIcon - ModelMoonshotIcon - ModelQwenIcon - ModelMetaIcon - ModelZhipuIcon description: The name of the icon to use in the UI FieldEnumItemMetadataSchema: type: object properties: link: type: string format: uri description: A link associated with the enum item data: description: Additional data for the enum item description: Additional metadata for the enum item ViewScalarFieldSchema: type: object properties: key: type: string label: type: string readonly: type: boolean sortable: type: boolean groupable_in: type: array items: $ref: '#/components/schemas/TableViewKindSchema' kind: type: string enum: - scalar type: $ref: '#/components/schemas/ViewScalarFieldTypeSchema' items: type: array items: $ref: '#/components/schemas/FieldEnumItemSchema' required: - key - readonly - sortable - groupable_in - kind - type ViewRefOneFieldSchema: type: object properties: key: type: string label: type: string readonly: type: boolean sortable: type: boolean groupable_in: type: array items: $ref: '#/components/schemas/TableViewKindSchema' kind: type: string enum: - ref-1 type: $ref: '#/components/schemas/ViewRefOneFieldTypeSchema' required: - key - readonly - sortable - groupable_in - kind - type TableViewKindSchema: type: string enum: - table - board - calendar - timeline - list - gallery ViewScalarFieldTypeSchema: type: string enum: - string - number - boolean - date - datetime - enum ViewRefOneFieldTypeSchema: type: string enum: - user - record - contact - chat - file - assistant - segment securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: Bearer token authentication using your API key ````