Conversations

Create a content fragment

Changed on Oct 21, 2026

Create a new content fragment in the workspace identified by {wId}.

post/api/v1/w/{wId}/assistant/conversations/{cId}/content_fragments

Request

Base URL
https://dust.tt
Auth
HTTP bearer
TypeScript
https://skmtc.dev/dust-tt/apis/dust-api-documentation/docs/api/v1/w/:wId/assistant/conversations/:cId/content_fragments/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

wIdstring required

ID of the workspace

cIdstring required

ID of the conversation

Request body

titlestring required

The title of the content fragment

contentstring

The content of the content fragment (optional if fileId is set)

contentTypestring

The content type of the content fragment (optional if fileId is set)

urlstring

The URL of the content fragment

fileIdstring

The id of the previously uploaded file (optional if content and contentType are set)

pathstring nullable

Path of this file inside the sandbox conversation mount.

processedPathstring nullable

Path of the plain-text sibling of this file inside the sandbox conversation mount (e.g. an audio transcript), when it has one.

skipFileProcessingboolean

Whether upload-time file processing was skipped.

nodeIdstring

The id of the content node (optional if content and contentType are set)

nodeDataSourceViewIdstring

The id of the data source view (optional if content and contentType are set)

Example request

{
  "title": "My content fragment",
  "content": "This is my content fragment extracted text",
  "contentType": "text/plain",
  "url": "https://example.com/content",
  "fileId": "fil_123456",
  "path": "conversation/report.csv",
  "processedPath": "conversation/voice.processed.txt",
  "nodeId": "node_123456",
  "nodeDataSourceViewId": "dsv_123456",
  "context": {
    "username": "johndoe123",
    "timezone": "America/New_York",
    "fullName": "John Doe",
    "email": "john.doe@example.com",
    "profilePictureUrl": "https://example.com/profiles/johndoe123.jpg",
    "agenticMessageData": {
      "originMessageId": "2b8e4f6a0c"
    }
  }
}

Response

Content fragment created successfully.