Learn about other types supported by the monday platform API
Account product
The AccountProduct
type is a field on workspaces
queries and contains metadata about the account product the queried workspace is in.
Fields
Field | Description | Enum values |
---|---|---|
id Int | The unique identifier of the account product. | |
kind AccountProductKind | The account product. | core , crm , forms , marketing , projectManagement , project_management , service , software , whiteboard |
Change team memberships result
The ChangeTeamsMembershipResult
type contains fields that show the result of adding or removing users from a team for the add_users_to_team
and remove_users_from_team
mutations.
mutation {
add_users_to_team (team_id: 7654321, user_ids: [123456, 654321, 012345]) {
successful_users {
name
email
}
failed_users {
name
email
}
}
}
Fields
Field | Description |
---|---|
failed_users [User!] | The users the team membership update failed for. |
successful_users [User!] | The users the team membership update succeeded for. |
Column mapping input
The ColumnMappingInput
type is an argument on the move_items_to_board
mutation that defines the column mapping between the target and source boards.
Fields
Field | Description |
---|---|
source ID! | The source column's unique identifier. |
target ID | The target column's unique identifier. |
Column type
ColumnType
accepts enum values to specify which column type to filter, read, or update in your query or mutation.
Enum values
auto_number | long_text |
board_relation | mirror |
button | name |
checkbox | numbers |
color_picker | people |
country | phone |
creation_log | progress |
date | rating |
dependency | status |
doc | subtasks |
dropdown | tags |
team | |
file | text |
formula | timeline |
hour | time_tracking |
item_assignees | vote |
item_id | week |
last_updated | world_clock |
link | unsupported |
location |
Create doc input
The CreateDocInput!
type is an argument for the create_doc
mutation that contains a set of arguments to specify where to create the new doc.
Fields
Field | Description | Supported arguments |
---|---|---|
board CreateDocBoardInput | The new document's location (when creating a doc on a board). | column_id String! item_id ID! |
workspace CreateDocWorkspaceInput | The new document's location (when creating a doc in a workspace). | kind BoardKind name String! workspace_id ID! |
Create doc board input
The CreateDocBoardInput
type is used to specify the item and column where you want to create the new document.
Fields
Field | Description |
---|---|
column_id String! | The unique identifier of the column to create the new doc in. |
item_id ID! | The unique identifier of the item to create the new doc on. |
Create doc workspace input
The CreateDocWorkspaceInput
type is used to specify the workspace where you want to create a document and the new document's name and kind.
Fields
Field | Description | Enum values |
---|---|---|
kind BoardKind | The kind of document to create. | private public share |
name String! | The new document's name. | |
workspace_id ID! | The unique identifier of the workspace to create the new doc in. |
Create team
Create team attributes input
The CreateTeamAttributesInput!
type is used to specify the characteristics of the new team being created via the API.
Only available in API versions
2025-01
and later
Fields
Field | Description |
---|---|
is_guest_team Boolean | Whether or not the new team contains guest users. |
name String! | The new team's name. |
parent_team_id ID | The parent team's unique identifier. |
subscriber_ids [ID!] | The team members's unique identifiers. Cannot be empty unless allow_empty_team is set. |
Create team options input
The CreateTeamOptionsInput
type is used to specify the options when creating a new team via the API.
Only available in API versions
2025-01
and later
Fields
Field | Description |
---|---|
allow_empty_team Boolean | Whether or not the team can have no subscribers. |
Items page by column values query
The ItemsPageByColumnValuesQuery
type is used as an argument for the items_page_by_column_values
object and contains a set of fields used to specify which columns and column values to filter your results by.
Fields
Field | Description |
---|---|
column_id String! | The IDs of the specific columns to return results for. |
column_values [String]! | The column values to filter items by. |
Items query
The ItemsQuery
type is used as an argument for the items_page
object and contains a set of parameters to filter, sort, and control the scope of the boards
query.
Fields
Field | Description | Enum values | Supported arguments |
---|---|---|---|
ids [ID!] | The specific item IDs to return. The maximum is 100. | ||
rules [ItemsQueryRule!] | The rules to filter your queries. | column_id ID! compare_attribute String compare_value CompareValue! operator ItemsQueryRuleOperator | |
operator ItemsQueryOperator | The conditions between query rules. The default is and. | and , or | |
order_by [ItemsQueryOrderBy!] | The attributes to sort results by. | column_id String! direction ItemsOrderByDirection |
[ItemsQueryRule!]
[ItemsQueryRule!]
The rules to filter your queries.
Fields
Field | Description | Enum values |
---|---|---|
column_id ID! | The unique identifier of the column to filter by. | |
compare_attribute String | The comparison attribute. You can find the supported attributes for each column type in the column types reference. Please note that most columns don't have a compare_attribute . | |
compare_value CompareValue! | The column value to filter by. This can be a string or index value depending on the column type. You can find the supported values for each column type in the column types reference. | |
operator ItemsQueryRuleOperator | The condition for value comparison. The default is any_of. | any_of not_any_of is_empty is_not_empty greater_than greater_than_or_equals lower_than lower_than_or_equal between not_contains_text contains_text contains_terms starts_with ends_with within_the_next within_the_last |
[ItemsQueryOrderBy!]
[ItemsQueryOrderBy!]
The attributes to sort results by.
Fields
Field | Description | Enum values |
---|---|---|
column_id String! | The unique identifier of the column to filter or sort by. You can also enter "__creation_log__" or "__last_updated__" to chronologically sort results by their last updated or creation date (oldest to newest). | |
direction ItemsOrderByDirection | The direction to sort items in. The default is asc. | asc desc |
Like
The Like
type is used as a field on updates
queries and contains a set of fields to return details about the update's reactions or likes.
Fields
Fields | Description | Enum values |
---|---|---|
created_at Date | The like's creation date. | |
creator User | The user that liked the update. | |
creator_id String | The unique identifier of the user that liked the update. | |
id ID! | The like's unique identifier. | |
reaction_type ReactionType | The reaction type. | Clap Happy Like Love PlusOne Rocks Trophy Wow |
updated_at Date | The like's last updated date. |
Linked items
The linked_items
field returns an item's linked items on an items
query.
Arguments
Arguments | Description |
---|---|
linked_board_id Int! | The linked board's unique identifier. |
link_to_item_column_id String! | The link to item column's unique identifier. |
Mirrored item
The MirroredItem
type is used as a field on the MirrorValue
implementation and contains a set of fields to return details about an item's mirrored items.
Fields
Fields | Description | Possible types |
---|---|---|
linked_board Board! | The linked board. | |
linked_board_id ID! | The linked board's unique identifier. | |
linked_item Item! | The linked item. | |
mirrored_value MirroredValue | The mirrored values. | Board , BoardRelationValue , ButtonValue , CheckboxValue , ColorPickerValue , CountryValue , CreationLogValue , DateValue , DependencyValue , DocValue , DropdownValue , EmailValue , FileValue , FormulaValue , Group , HourValue , ItemIdValue , LastUpdatedValue , LinkValue , LocationValue , LongTextValue , MirrorValue , NumbersValue , PeopleValue , PhoneValue , ProgressValue , RatingValue , StatusValue , SubtasksValue , TagsValue , TeamValue , TextValue , TimeTrackingValue , TimelineValue , UnsupportedValue , VoteValue , WeekValue , WorldClockValue |
Number value unit direction
The NumberValueUnitDirection
type is used as a field on the NumbersValue
implementation that indicates whether the unit symbol is placed to the right or left of a number value.
Enum values
Enum values | Description |
---|---|
left | The symbol is placed to the left of the number. |
right | The symbol is placed to the right of the number. |
People entity
The PeopleEntity
type is used as a field on the PeopleValue
implementation that contains the column's people or team values.
Fields
Field | Description | Enum values |
---|---|---|
id ID! | The unique identifier of the person or team. | |
kind Kind | The type of entity. | person team |
Reply
The Reply
type is used as a field on updates
queries and contains a set of fields to return details about the update's replies.
Fields
Fields | Description | Supported fields |
---|---|---|
body String! | The reply's HTML-formatted body. | |
created_at Date | The reply's creation date. | |
creator User | The reply's creator. | |
creator_id String | The unique identifier of the reply's creator. | |
id ID! | The reply's unique identifier. | |
kind String! | The reply's kind. Please note that this field is only available in API versions 2024-10 and later. | |
likes [Like!]! | The reply's likes. Please note that this field is only available in API versions 2024-10 and later. | created_at Date creator User creator_id String id ID! reaction_type ReactionType updated_at Date |
pinned_to_top [UpdatePin!]! | The reply's pin to top data. Please note that this field is only available in API versions 2024-10 and later. | item_id Int! |
text_body String | The reply's text body. | |
updated_at Date | The reply's last updated date. |
Status label style
The StatusLabelStyle
type is used as a field on the StatusValue
implementation and contains a set of fields that return details about the status label's style.
Fields
Field | Description |
---|---|
border String! | The label's border Hex color code. |
color String! | The label's Hex color code. |
Position relative
The PositionRelative
type is used as an argument on the create_item
and create_group
mutations. It contains a set of enum values to determine the location of the item or group being created.
Enum value | Description |
---|---|
after_at | Creates the new group or item below the relative_to value. |
before_at | Creates the new group or item above the relative_to value. |
Time tracking history item
The TimeTrackingHistoryItem
type is used as a field on the TimeTrackingValue
implementation and contains a set of fields that returns data about the time tracking column history.
Field | Description |
---|---|
created_at Date! | The date the session was added to the item. |
ended_at Date | The date the session ended. |
ended_user_id ID | The unique identifier of the user that ended the time tracking. |
id ID! | The unique session identifier. |
manually_entered_end_date Boolean! | Returns true if the session end date was manually entered. |
manually_entered_end_time Boolean! | Returns true if the session end time was manually entered. |
manually_entered_start_date Boolean! | Returns true if the session start date was manually entered. |
manually_entered_start_time Boolean! | Returns true if the session start time was manually entered. |
started_at Date | The date the session was started. Only applicable if the session was started by pressing the play button or through an automation. |
started_user_id ID | The unique identifier of the user that started the time tracking. |
status String! | The session's status. |
updated_at Date | The date the session was updated. |
Update workspace attributes input
The UpdateWorkspaceAttributesInput
type is used as an argument on the update_workspace
mutation and contains fields to specify what attributes to update.
Field | Description | Enum values |
---|---|---|
description String | The updated workspace description. | |
kind WorkspaceKind | The kind of workspace to update. | closed open |
name String | The updated workspace name. |