The monday.com favorites API lets you query a user's favorites.

Each of the object types described below represents a specific aspect of a favorite. They can be queried as subfields on the favorites query or provide favorite metadata in mutations.

CreateFavoriteInput

An object containing the input of the new favorite to create.

Field	Description	Input Fields
name `String`	The name of the object to mark as a favorite.
newPosition `ObjectDynamicPositionInput`	The new position of the favorite object.	nextObject `HierarchyObjectIDInputType` prevObject `HierarchyObjectIDInputType`
object `HierarchyObjectIDInputType!`	The type of object to mark as a favorite.	id `ID!` type `ObjectType!`

CreateFavoriteResultType

An object containing the result of creating a new favorite via the API.

Field	Description	Supported Subfields
favorites `HierarchyObjectItem`	The new favorite object's metadata.	accountId `Int` createdAt `Date` folderId `ID` hierarchyListData `ListID` id `ID` object `HierarchyObjectID` position `Float` updatedAt `Date`

DeleteFavoriteInput

An object containing the input of the favorite to delete.

Field	Description	Input Fields
object `HierarchyObjectIDInputType!`	The object to remove from the favorites.	id `ID!` type `ObjectType!`

DeleteFavoriteInputResultType

An object containing the result of deleting a favorite object via the API.

Field	Description
success `Boolean`	Whether the favorite was successfully deleted.

HierarchyObjectId

An object containing metadata about the favorited object.

Field	Description	Enum values
id `ID`	The object's unique identifier.
type `ObjectType`	The object's type.	`Board` `Folder` `Overview`

HierarchyObjectIDInputType

Metadata about the favorite object.

Field	Description	Enum Values
id `ID!`	The object's unique identifier.
type `ObjectType!`	The object's type.	`Board` `Folder` `Overview` (dashboard)

ListID

An object containing metadata about the favorited list.

Field	Description	Enum values
id `ID`	The list's unique identifier.
type `ListType`	The list's type.	`CustomizedList` `PersonalList` `Workspace`

UpdateObjectHierarchyPositionInput

An object containing the input of the favorite to update.

Field	Description	Input Fields
newFolder `ID`	The unique identifier of the folder to move the favorite object into.
newPosition `ObjectDynamicPositionInput`	The new position of the favorite object in the favorites list.	nextObject `HierarchyObjectIDInputType` prevObject `HierarchyObjectIDInputType`
object `HierarchyObjectIDInputType!`	The favorite object to update.

UpdateFavoriteResultType

An object containing the result of updating a favorite object's position via the API.

Field	Description	Supported Subfields
favorites `HierarchyObjectItem`	The updated favorite object's metadata.	accountId `Int` createdAt `Date` folderId `ID` hierarchyListData `ListID` id `ID` object `HierarchyObjectID` position `Float` updatedAt `Date`