The monday.com object schemas API lets you manage the column structure applied across boards in your account. The types below are used as inputs and return types across the object schema queries and mutations.

ObjectSchemaColumn

Represents a column defined within an object schema.

Field	Type	Description
description	`String`	The column's description. Returns `null` if not set.
id	`ID!`	The column's unique identifier.
policy	`ObjectSchemaColumnPolicy`	The policy rules governing this column. Returns `null` if no policy is set.
settings	`JSON`	The column's type-specific configuration as a JSON object.
tags	`ObjectSchemaColumnTags`	Status tags for this column (deprecation, opt-in, inheritance info).
title	`String!`	The column's display title.
type	`ColumnType`	The column's type.

ObjectSchemaColumnPolicy

Defines the policy rules that govern a column's behavior and what boards can override.

Field	Type	Description
can_override	`[String!]!`	The fields that connected boards are allowed to override: `settings`, `title`, `description`.
cannot_delete	`Boolean!`	When `true`, the column cannot be deleted.
messages	`JSON`	User-facing messages explaining why specific actions are disabled. Returns `null` if not set.
read_only	`Boolean!`	When `true`, the column is read-only for boards.

ObjectSchemaColumnTags

Status tags that indicate the current state of a column within an object schema.

Field	Type	Description
deprecated	`JSON`	Deprecation metadata, including a `start` timestamp. Returns `null` if the column is not deprecated.
inherited	`Boolean`	When `true`, the column is inherited from a parent object schema.
opt_in_by_default	`JSON`	Opt-in metadata, including an optional `end` timestamp. Returns `null` if the column uses opt-out behavior.

ObjectSchemaActionResult

Represents the result of a single action executed within a bulk_object_schema_column_actions mutation.

Field	Type	Description
action	`ObjectSchemaAction!`	The action type that was performed.
object_schema	`ObjectSchema!`	The state of the object schema after the action was applied.

BoardConnection

Represents the connection between a board and an object schema, returned by the connect_board_to_object_schema mutation.

Field	Type	Description
id	`ID!`	The board's unique identifier.
object_schema_id	`ID`	The unique identifier of the connected object schema. Returns `null` if the board is not connected to a schema.

BulkDetachBoardResult

Represents the result of a single detach operation within a detach_boards_from_object_schema mutation.

Field	Type	Description
board_id	`ID!`	The unique identifier of the board that was detached.
error	`String`	The error message if the detach operation failed. Returns `null` on success.
success	`Boolean!`	When `true`, the board was successfully detached.

CreateObjectSchemaColumnInput

Input type for creating a new column on an object schema.

Field	Type	Description
defaults	`JSON`	Type-specific configuration for the column (e.g. labels for a status column).
description	`String`	The column's description.
opt_out_by_default	`Boolean`	When `true`, connected boards opt out of this column by default. The default is `false` (opt-in).
policy	`ColumnPolicyInput!`	The policy rules for this column.
title	`String!`	The column's display title.
type	`ColumnType!`	The column's type.

UpdateObjectSchemaColumnInput

Input type for updating an existing column on an object schema.

Field	Type	Description
column_id	`ID!`	The unique identifier of the column to update.
defaults	`JSON`	Updated type-specific configuration for the column.
description	`String`	The updated column description.
opt_out_by_default	`Boolean`	Updated opt-out behavior for the column.
policy	`ColumnPolicyInput`	Updated policy rules for the column.
title	`String`	The updated column title.

ColumnPolicyInput

Input type for defining a column's policy rules.

Field	Type	Description
can_override	`[CanOverrideField!]!`	The fields that connected boards are allowed to override.
cannot_delete	`Boolean!`	When `true`, prevents boards from deleting this column.
messages	`PolicyMessagesInput`	User-facing messages explaining why specific actions are disabled on connected boards.

PolicyMessagesInput

Input type for configuring user-facing messages on a column policy.

Field	Type	Description
disabled_reason	`DisabledReasonInput`	Messages explaining why specific column actions are disabled.

DisabledReasonInput

Input type for per-action disabled reason messages displayed to board users.

Field	Type	Description
delete	`String`	Reason why the column cannot be deleted.
edit_description	`String`	Reason why the column description cannot be edited.
edit_labels	`String`	Reason why the column labels cannot be edited.
edit_labels_positions_v2	`String`	Reason why the column label positions cannot be edited.
edit_settings	`String`	Reason why the column settings cannot be edited.
edit_title	`String`	Reason why the column title cannot be edited.

ObjectSchemaActionInput

Input type for a single action within the bulk_object_schema_column_actions mutation.

Field	Type	Description
action	`ObjectSchemaAction!`	The type of action to execute.
create_object_schema_columns	`CreateObjectSchemaColumnsActionInput`	The columns to create. Required when `action` is `CREATE_OBJECT_SCHEMA_COLUMNS`.
delete_object_schema_columns	`DeleteObjectSchemaColumnsActionInput`	The column IDs to delete. Required when `action` is `DELETE_OBJECT_SCHEMA_COLUMNS`.
update_object_schema_columns	`UpdateObjectSchemaColumnsActionInput`	The column updates to apply. Required when `action` is `UPDATE_OBJECT_SCHEMA_COLUMNS`.

CreateObjectSchemaColumnsActionInput

Input type for the create columns action within a bulk operation.

Field	Type	Description
columns	`[CreateObjectSchemaColumnInput!]!`	An array of column definitions to create.

UpdateObjectSchemaColumnsActionInput

Input type for the update columns action within a bulk operation.

Field	Type	Description
columns	`[UpdateObjectSchemaColumnInput!]!`	An array of column updates to apply.

DeleteObjectSchemaColumnsActionInput

Input type for the delete columns action within a bulk operation.

Field	Type	Description
column_ids	`[ID!]!`	An array of column IDs to delete.

ObjectSchemaAction

Enum of supported action types for bulk_object_schema_column_actions.

Enum Value	Description
`CREATE_OBJECT_SCHEMA_COLUMNS`	Creates columns on the object schema.
`DELETE_OBJECT_SCHEMA_COLUMNS`	Deletes columns from the object schema.
`UPDATE_OBJECT_SCHEMA_COLUMNS`	Updates columns on the object schema.

ColumnActiveStateAction

Enum of supported actions for set_object_schema_column_active_state.

Enum Value	Description
`DEACTIVATE`	Deprecates the column on the object schema.
`REACTIVATE`	Restores a previously deprecated column.

CanOverrideField

Enum of fields that connected boards are permitted to override on a schema column.

Enum Value	Description
`description`	Boards can override the column's description.
`settings`	Boards can override the column's type-specific settings.
`title`	Boards can override the column's display title.