v46

latestOpenAPI 3.0.0MITraw.githubusercontent.com2026-08-0311978417.1 KB

Conversations

Create a content fragment

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

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

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.

skipDataSourceIndexingboolean

Whether data source indexing was skipped for this file.

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.