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 | The unique identifier of the board to convert. | |
callback_url | The URL to receive async operation results (optional, but recommended). | |
column_mappings | The mapping of project field keys to existing board column IDs. | project_owner |
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. |