Skip to content

Commit c7d1b6b

Browse files
committed
fix(docs): clarify supported integration operations and trigger events
1 parent 82ed905 commit c7d1b6b

36 files changed

Lines changed: 88 additions & 77 deletions

‎apps/docs/INTEGRATIONS_AUDIT.md‎

Lines changed: 8 additions & 5 deletions
Large diffs are not rendered by default.

‎apps/docs/content/docs/integrations/affinity.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1111
/>
1212

1313
{/* MANUAL-CONTENT-START:intro */}
14-
[Affinity](https://www.affinity.co/) is a CRM for companies, people, opportunities, and relationship data. Its v2 integration can read and update records, lists, field values, notes, interactions, and transcripts.
14+
[Affinity](https://www.affinity.co/) is a CRM for companies, people, opportunities, and relationship data. Its v2 integration reads companies, people, opportunities, lists, interactions, and transcripts; creates lists and reminders; manages notes; and updates field values and dropdown options.
1515

1616
Discover a workspace’s list fields and dropdown options before writing values. Use bulk field operations for multiple changes and follow the field-value change feed from a stored cursor for incremental sync. Relationship and inferred-connection operations help find introduction paths; Semantic Search finds companies from an investment description.
1717

@@ -28,7 +28,7 @@ Some Affinity endpoints are still marked BETA — company, person, and list-entr
2828

2929
## Use the block [#usage-instructions]
3030

31-
Read and search Affinity companies, people, opportunities, lists, and saved views. Read or update field values, notes, and reminders; retrieve interactions and transcripts; discover relationship paths; and follow field changes for incremental synchronization. Access depends on the API key holder’s permissions.
31+
Read companies, people, opportunities, lists, and saved views; search companies, people, list entries, notes, and files. Read or update field values and notes; list or create reminders; retrieve interactions and transcripts; discover relationship paths; and follow field changes for incremental synchronization. Access depends on the API key holder’s permissions.
3232

3333
## Actions
3434

‎apps/docs/content/docs/integrations/airtable.mdx‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1212

1313
{/* MANUAL-CONTENT-START:intro */}
1414
Use [Airtable](https://airtable.com/) to list bases and table schemas, read or write records, and start workflows from record changes. For token setup, see [Personal Access Tokens](/integrations/airtable-service-account).
15+
16+
Trigger mode handles record creation, updates, and deletion. Inspect `payloads` or `latestPayload` for Airtable's raw changes; deleted record IDs are under `changedTablesById[tableId].destroyedRecordIds`. The `airtableChanges` array currently consolidates created and updated records and returns changed cell values in `changedFields`.
1517
{/* MANUAL-CONTENT-END */}
1618

1719

@@ -34,7 +36,7 @@ Sim requests these scopes when someone connects an Airtable account. For a self-
3436

3537
## Use the block [#usage-instructions]
3638

37-
List bases, list tables (with schema), and create, get, list, update, upsert, or delete records. Use trigger mode to start a workflow when an update is made to an Airtable table.
39+
List bases, list tables (with schema), and create, get, list, update, upsert, or delete records. Use trigger mode to start a workflow when a record is created, updated, or deleted in an Airtable table.
3840

3941
## Actions
4042

@@ -325,9 +327,9 @@ Trigger workflow from Airtable record changes like create, update, and delete ev
325327
| ↳ `cellValuesByFieldId` | object | Cell values keyed by field ID |
326328
| ↳ `createdRecordsById` | object | Created records by ID |
327329
| ↳ `destroyedRecordIds` | array | Array of destroyed record IDs |
328-
| `airtableChanges` | array | Changes made to the Airtable table |
330+
| `airtableChanges` | array | Consolidated record creations and updates. Deleted record IDs remain in raw payloads. |
329331
| ↳ `tableId` | string | Table ID |
330332
| ↳ `recordId` | string | Record ID |
331-
| ↳ `changeType` | string | Type of change \(created, changed, destroyed\) |
333+
| ↳ `changeType` | string | Type of consolidated change: created or updated |
332334
| ↳ `cellValuesByFieldId` | object | Cell values by field ID |
333335

‎apps/docs/content/docs/integrations/databricks.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Genie operations ask a space questions in natural language and return answers, g
1919

2020
## Use the block [#usage-instructions]
2121

22-
Run SQL against Databricks warehouses, trigger and monitor job runs, inspect clusters, and retrieve run output. Ask a Genie space questions, continue a conversation, or run Genie agent research. Supply a personal access token and workspace host URL.
22+
Run SQL against Databricks warehouses, trigger and monitor job runs, inspect clusters, and retrieve run output. Ask questions of a Genie space, continue a conversation, or run Genie agent research. Supply a personal access token and workspace host URL.
2323

2424
## Actions
2525

‎apps/docs/content/docs/integrations/dropbox.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1111
/>
1212

1313
{/* MANUAL-CONTENT-START:intro */}
14-
Use [Dropbox](https://dropbox.com/) to upload and download files, list folders, search content, create folders, and manage shared links. The actions also move, rename, or delete files and folders. Select a connected Dropbox credential and the path or item identifier required by the action.
14+
Use [Dropbox](https://dropbox.com/) to upload and download files, list folders, search content, create folders, and manage shared links. The actions also move or rename files and folders. Delete File/Folder moves them to the trash. Select a connected Dropbox credential and the path or item identifier required by the action.
1515
{/* MANUAL-CONTENT-END */}
1616

1717

@@ -36,7 +36,7 @@ Sim requests these scopes when someone connects a Dropbox account. For a self-ho
3636

3737
## Use the block [#usage-instructions]
3838

39-
Upload and download files, list and search folders, create folders, manage shared links, and move or delete items.
39+
Upload and download files, list and search folders, create folders, manage shared links, and move items between folders or to the trash.
4040

4141
## Actions
4242

‎apps/docs/content/docs/integrations/dub.mdx‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,15 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1111
/>
1212

1313
{/* MANUAL-CONTENT-START:intro */}
14-
Use [Dub](https://dub.co/) to create and manage short links with custom domains, slugs, UTM parameters, and metadata. **Upsert Link** creates or updates a link by destination URL; lookup and deletion also support the identifiers documented for each action.
14+
Use [Dub](https://dub.co/) to create and manage short links with custom domains, slugs, UTM parameters, and link-preview titles and descriptions. **Upsert Link** creates or updates a link by destination URL; lookup and deletion also support the identifiers documented for each action.
1515

1616
List actions support filtering, sorting, and pagination. Analytics report clicks, leads, and sales, with grouping by time, geography, device, browser, referrer, and other supported dimensions.
1717
{/* MANUAL-CONTENT-END */}
1818

1919

2020
## Use the block [#usage-instructions]
2121

22-
Create, update, delete, or list short links with custom domains, slugs, metadata, and UTM parameters. Retrieve click, lead, and sales analytics.
22+
Create, update, delete, or list short links with custom domains, slugs, link-preview titles and descriptions, and UTM parameters. Retrieve click, lead, and sales analytics.
2323

2424
## Actions
2525

@@ -195,7 +195,7 @@ Retrieve information about a short link by its link ID, external ID, or domain +
195195

196196
### Dub Update Link
197197

198-
Update an existing short link. You can modify the destination URL, slug, metadata, UTM parameters, and more.
198+
Update an existing short link's destination URL, domain, slug, link-preview title and description, UTM parameters, and other supported settings.
199199

200200
#### Input
201201

‎apps/docs/content/docs/integrations/gong.mdx‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Gong
3-
description: Read Gong calls, transcripts, users, and coaching metrics
3+
description: Read Gong data, upload calls, assign or unassign flow prospects, and request data erasure
44
---
55

66
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -14,12 +14,14 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1414
Use [Gong](https://www.gong.io/) to list calls, read call details and transcripts, and retrieve topics, trackers, interaction statistics, and other extensive call data. The actions also read users, activity and coaching metrics, answered scorecards, scorecard definitions, tracker configuration, call-library folders and content, and Engage flows.
1515

1616
Look up an email address or phone number to find related calls, emails, meetings, CRM records, and engagement events. Connect your Gong API credentials and inspect the returned data when preparing coaching reports or syncing conversations to another system.
17+
18+
**Create Call** uploads metadata and asks Gong to fetch the recording from a media URL. **Assign Flow Prospects** and **Unassign Flow Prospects** change a prospect’s Engage flow assignments. **Purge Email Address** and **Purge Phone Number** request deletion of associated Gong data. [Gong processes these deletions in the background](https://help.gong.io/docs/delete-personal-data); a returned request ID does not confirm completion.
1719
{/* MANUAL-CONTENT-END */}
1820

1921

2022
## Use the block [#usage-instructions]
2123

22-
Access call recordings, transcripts, user data, activity stats, scorecards, trackers, library content, coaching metrics, and more via the Gong API.
24+
Read calls, recording URLs, transcripts, user data, activity statistics, scorecards, trackers, library content, coaching metrics, and Engage flows. Upload call metadata and let Gong fetch the media URL, assign or unassign flow prospects, and request data erasure for an email address or phone number.
2325

2426
## Actions
2527

‎apps/docs/content/docs/integrations/intercom.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,13 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1111
/>
1212

1313
{/* MANUAL-CONTENT-START:intro */}
14-
Use [Intercom](https://www.intercom.com/) in Sim to manage contacts and companies, read and reply to conversations, create and retrieve tickets, and send messages. Connect these operations to support triage, follow-up, and CRM synchronization workflows.
14+
Use [Intercom](https://www.intercom.com/) in Sim to manage contacts and companies, read and reply to conversations, create, retrieve, and update tickets, and send messages. Connect these operations to support triage, follow-up, and CRM synchronization workflows.
1515
{/* MANUAL-CONTENT-END */}
1616

1717

1818
## Use the block [#usage-instructions]
1919

20-
Create, get, update, list, search, and delete contacts; create, get, and list companies; get, list, reply, and search conversations; create and get tickets; and create messages.
20+
Create, get, update, list, search, and delete contacts; create, get, and list companies; get, list, reply, and search conversations; create, get, and update tickets; and create messages.
2121

2222
## Actions
2323

‎apps/docs/content/docs/integrations/knowledge.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Knowledge
3-
description: Search knowledge bases and manage documents, chunks, and tags
3+
description: Search knowledge bases and manage documents and chunks
44
---
55

66
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -17,7 +17,7 @@ Use the Knowledge block to search a Sim knowledge base and manage its documents
1717

1818
## Use the block [#usage-instructions]
1919

20-
Perform full CRUD operations on documents, chunks, and tags.
20+
Search knowledge bases and list, retrieve, create, upsert, or delete documents. Upload, list, update, or delete chunks, list tag definitions, and set document tags during creation or upsert. Inspect connectors and trigger syncs.
2121

2222
## Actions
2323

‎apps/docs/content/docs/integrations/managed_agent.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,13 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
1313
{/* MANUAL-CONTENT-START:intro */}
1414
Call a [Claude Managed Agent](https://www.anthropic.com/) hosted on the Claude Platform from a Sim workflow. Select a Claude Platform account, agent, and environment, then send the task message.
1515

16-
Optional inputs attach credential vaults, a memory store with read or write access and usage instructions, files, and metadata tags. The block returns the agent's final text, session ID, and token usage for downstream processing and cost tracking. Session actions also create, inspect, interrupt, archive, update, or delete sessions; read events; and submit custom-tool results or confirmation responses. File attachments are supported for cloud environments.
16+
Optional inputs attach credential vaults, a memory store with read or write access and usage instructions, files, and metadata tags. The **Run session (create, send, wait for reply)** operation waits for the reply and returns final text and a session ID, with token usage when available, for downstream processing and cost tracking. Outputs from the other operations depend on the selected action. Session actions also create, inspect, interrupt, archive, update, or delete sessions; read events; and submit custom-tool results or confirmation responses. File attachments are supported for cloud environments.
1717
{/* MANUAL-CONTENT-END */}
1818

1919

2020
## Use the block [#usage-instructions]
2121

22-
Select a Claude Platform account, agent, and environment, then send a task. Optionally attach vaults, a memory store, files, and metadata. Returns the agent’s final text, session ID, and token usage.
22+
Run or create a session with a Claude Platform account, agent, and environment. Optionally attach vaults, a memory store, files, and metadata. The Run session operation waits for the agent’s reply and returns final text and a session ID, with token usage when available. Outputs from other operations depend on the selected action.
2323

2424
## Actions
2525

0 commit comments

Comments
 (0)