View as Markdown
Dust icon

Dust ACTION

Upsert Document

Upsert a document to a chosen Dust data source. See the documentation
  • Action
  • Writes data
  • Destructive
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Dust account once, then configure and run Upsert Document from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "dust-upsert-document",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    dust: { authProvisionId: "apn_xxxxxxx" },
    dataSourceId: "Folder ID",
    documentId: "Document Id",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Upsert Document inputs
Property Type Description
dataSourceId Folder ID string
ID of the data source.
Required Dynamic
documentId Document Id string
An Id for the new document
Required
content Content string
The text content of the document to upsert.
Required
lightDocumentOutput Light Document Output boolean
If true, a lightweight version of the document will be returned in the response (excluding the text, chunks and vectors). Defaults to false.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
dust-upsert-document
Version
0.0.2
App
Dust
Authentication
API key
Read-only
No
Destructive
Yes
Open world
Yes