v51

latestOpenAPI 3.0.3AGPL-3.0-or-laterraw.githubusercontent.com2026-08-017215661.2 KB

api_columns

[api v2] Create new selection column

Specify a subtype to use any special selection column

post/ocs/v2.php/apps/tables/api/2/columns/selection

OCS-APIRequestboolean required

Required to be true for the API request to pass

baseNodeIdinteger required

Context of the column creation

titlestring required

Title

technicalNamestring nullable

Technical name of the column

selectionOptionsstring required

Json array{id: int, label: string} with options that can be selected, eg [{"id": 1, "label": "first"},{"id": 2, "label": "second"}]

selectionDefaultstring nullable

Json int|list<int> for default selected option(s), eg 5 or ["1", "8"]

subtype'progress' | 'stars' nullable

Subtype for the new column

descriptionstring nullable

Description

selectedViewIdsinteger[] nullable

View IDs where this columns should be added

mandatoryboolean

Is mandatory

baseNodeType'table' | 'view'

Context type of the column creation

customSettingsobject

Custom settings for the column

Column created