View as Markdown
Writer icon

Writer ACTION

List Knowledge Graphs

List the Knowledge Graphs in your Writer workspace. Knowledge Graphs are the retrieval (RAG) sources you can query. Use this to find a graph by name/topic and resolve its id, then pass the id(s) to Ask Knowledge Graph to ask a grounded question. Auto-paginates up to 200 graphs. Example: to get just the names of your graphs, call with fields=["name"] -> returns records like { id: "...", name: "Isla Nublar Field Guide" }. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Writer account once, then configure and run List Knowledge Graphs 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: "writer-list-knowledge-graphs",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    writer: { authProvisionId: "apn_xxxxxxx" },
    fields: ["Fields"],
    maxResults: 10,
  },
})

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.

List Knowledge Graphs inputs
Property Type Description
fields Fields string[]
Field names to return for each Knowledge Graph (id is always included). Defaults to: name, description, type. Available fields include name, description, type, file_status, created_at, urls. Pass only what you need to keep responses small.
Optional
maxResults Max Results integer
Maximum number of results to return.
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
writer-list-knowledge-graphs
Version
0.0.2
App
Writer
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes