🚧 The following types are only available in API versions 2025-10 and later
The monday.com portfolio API lets you create portfolio solution boards.
Each object type described below represents a specific part of a portfolio solution. You can use these object types to supply metadata in mutations or to define which fields should be returned in your queries.
ConnectProjectResult
An object containing the result of connecting a portfolio and project board via the API.
| Field | Description |
|---|---|
message String | A message describing the result of the operation. |
portfolio_item_id String | The unique identifier of the portfolio item that was created (if successful). |
success Boolean | Whether the operation was successful. |
ConvertBoardToProjectInput
An object containing the board's properties.
| Field | Description | Supported Subfields |
|---|---|---|
board_id ID! | The unique identifier of the board to convert. | |
callback_url String | The URL to receive async operation results (optional, but recommended). | |
column_mappings ColumnsMappingInput! | The mapping of project field keys to existing board column IDs. | project_owner ID!project_status ID!project_timeline ID! |
ColumnsMappingInput
An object containing the column mapping properties.
| Field | Description |
|---|---|
project_owner ID! | The column representing the project's owner. |
project_status ID! | The column representing the project's status. |
project_timeline ID! | The column representing the project's timeline or dates. |
ConvertBoardToProjectResult
An object containing the result of converting an existing board to a project board via the API.
| Field | Description |
|---|---|
message String | A message describing the result of the operation. |
process_id String | The unique identifier that's generated for this process and will be sent to the callback request. |
projectId ID | The new project board's unique identifier. |
success Boolean | Whether the operation was successful. |
CreatePortfolioResult
An object containing the result of creating a new portfolio board via the API.
| Field | Description |
|---|---|
message String | A message describing the result of the operation. |
solution_live_version_id String | The unique identifier of the solution that was created. |
success Boolean | Whether the operation was successful. |