Skip to content

Commit 99a0494

Browse files
devin-ai-integration[bot]bot_apk
andauthored
docs(source-monday): Improve documentation for column value types and fix prerequisites (#74297)
Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Co-authored-by: bot_apk <apk@cognition.ai>
1 parent 876d3e7 commit 99a0494

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

docs/integrations/sources/monday.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ This connector uses the [Monday.com GraphQL API](https://developer.monday.com/ap
88

99
To set up the Monday source connector, you need either:
1010

11-
- A **Personal API Token**, which you can generate from your Monday.com account under **Profile picture** (bottom left corner) > **Admin** > **API**.
12-
- An **OAuth 2.0 application**, which you can find or create under **Profile picture** (bottom left corner) > **Developers** > **My Apps**.
11+
- A **Personal API Token**, which you can generate from your Monday.com account under **Profile picture** (top right corner) > **Developers** > **API token**.
12+
- An **OAuth 2.0 application**, which you can find or create under **Profile picture** (top right corner) > **Developers** > **My Apps**.
1313

1414
For more details, see Monday.com's [authentication documentation](https://developer.monday.com/api-reference/docs/authentication).
1515

@@ -63,7 +63,10 @@ The following streams are available:
6363

6464
- The Boards stream includes column definitions for each board. In your destination, these appear as nested data, typically named `boards.columns`.
6565

66-
- The Items stream includes column values for each item. In your destination, these appear as nested data, typically named `items.column_values`.
66+
- The Items stream includes column values for each item. In your destination, these appear as nested data, typically named `items.column_values`. Each column value includes `id`, `text`, `type`, and `value` fields. Some column types provide additional fields through typed values:
67+
68+
- **Connect Boards** (`board_relation`) and **Dependency** (`dependency`) columns include a `linked_item_ids` array containing the IDs of linked items. Use these IDs to join back to the Items stream for details about linked items. Note that the `value` field returns `null` for these column types.
69+
- **Mirror**, **Connect Boards**, and **Dependency** columns include a `display_value` field with a human-readable text representation.
6770

6871
- Incremental sync for the Items and Boards streams relies on the Activity logs stream. Board and item IDs are extracted from activity log events and used to selectively sync only the changed records. If the time between syncs exceeds the activity log retention period for your [Monday.com plan](https://monday.com/pricing), some changes may not be captured during incremental syncs.
6972

0 commit comments

Comments
 (0)