Get Chat Record Citations
Retrieve referenced knowledge base chunk contents, scores, and source details for a specified chat message.
Endpoint Overview
- Method :
POST - Path :
/api/core/chat/record/getQuote - Module : Chat / Chat Records
- Authentication :
Authorization: Bearer <apiKey>—Supports App API Key (appIdoptional) and Personal API Key (appIdrequired); also supportsauthProxyteam member proxy andoutLinkAuthDatashare link (see API Getting Started ) - Interactive Try-It-Out : Open in Scalar API Explorer (self-hosted instances: replace the origin with
<instance>/apidoc/systemopenapi#tag/%E5%AF%B9%E8%AF%9D%E7%AE%A1%E7%90%86/POST/core/chat/record/getQuote)
Description & Notes
Retrieve dataset citation chunks for a specified chat message (requires chat read access).
Request Parameters
Request Body ( application/json )
Shared Parameters Across Branches
| Field | Type | Required | Default | Constraints & Description |
|---|---|---|---|---|
chatId | string | Yes | - | Chat ID. minLength: 1; maxLength: 1024 |
chatItemDataId | string | Yes | - | Chat message dataId . minLength: 1; maxLength: 256 |
datasetDataIdList | string[] | Yes | - | List of dataset data item IDs. maxItems: 200 |
collectionIdList | string[] | Yes | - | List of collection IDs. maxItems: 200 |
Mutually Exclusive Branches ( anyOf )
- App Chat
Identify the conversation via appId . When both API Key and login session are supported, Authorization takes precedence over token/Cookie.
| Field | Type | Required | Default | Constraints & Description |
|---|---|---|---|---|
appId | string | Yes | - | Application ID authenticated with the request header credentials allowed by this endpoint. pattern: ^[0-9a-fA-F]{24}$ |
sourceType | string (enum) | No | - | Session resource type associated with appId . Defaults to app ; pass the matching sourceType for assistant builder sessions. Allowed values: app , chatAgentHelper , workflowBuilder |
Default Identity : Omit customUid and authProxy to execute using the team member identity associated with the credential.
Custom end user ( customUid ): Tag end users from your own system via customUid without changing the authenticating member or permissions. Passed as workflow userId and used to scope chat management.
| Field | Type | Required | Default | Constraints & Description |
|---|---|---|---|---|
customUid | string | Yes | - | Supported only for standard app API Key calls. Exact match against the external user ID ( outLinkUid , not tmbId ). Omit to keep full scope or pass to restrict reads, updates, and deletions (max 1024 chars, cannot be empty or null , does not change member identity). minLength: 1; maxLength: 1024 |
Proxy Team Member ( authProxy ): Act on behalf of another member in the same team via authProxy . Available only on personal API keys with authProxy enabled; mutually exclusive with customUid .
| Field | Type | Required | Default | Constraints & Description |
|---|---|---|---|---|
authProxy | object | Yes | - | API Key proxy caller identity. Available only for personal keys with authProxy enabled; specify tmbId or username ( tmbId takes precedence without falling back to username on invalid ID). |
authProxy.tmbId | string | Yes | - | Branch: By Team Member ID . Proxied team member ID ( tmbId ), takes precedence over username . pattern: ^[0-9a-fA-F]{24}$ |
authProxy.username | string | Yes | - | Branch: By Username . Proxied team member username. minLength: 1; maxLength: 128 |
- Skill Debug Session
Identify the debug session via skillId (takes precedence over appId and ignores sourceType ), authenticated with allowed request header credentials.
| Field | Type | Required | Default | Constraints & Description |
|---|---|---|---|---|
skillId | string | Yes | - | Skill Edit debug ID authenticated with allowed request header credentials. pattern: ^[0-9a-fA-F]{24}$ |
- Share-Link Chat
Resolves the underlying app via outLinkAuthData , taking precedence over skillId and appId (ignoring sourceType ). Protected links still validate login cookies/tokens and never fall back to standard auth on failure.
| Field | Type | Required | Default | Constraints & Description |
|---|---|---|---|---|
outLinkAuthData | object | Yes | - | Share-link auth payload ( shareId / outLinkUid ). Overrides skillId and appId ; protected links still validate login session cookies/tokens. |
outLinkAuthData.shareId | string | Yes | - | Share link ID. minLength: 1 |
outLinkAuthData.outLinkUid | string | Yes | - | External share user ID. minLength: 1 |
- App API Key (no appId required)
When authorizing with an app-bound App API Key, omit appId and sourceType ; the server resolves the bound app with sourceType fixed to app . Personal keys and login sessions cannot omit appId , and an explicit appId does not override an App API Key binding.
Default Identity : Omit customUid and authProxy to execute using the team member identity associated with the credential.
Custom end user ( customUid ): Tag end users from your own system via customUid without changing the authenticating member or permissions. Passed as workflow userId and used to scope chat management.
| Field | Type | Required | Default | Constraints & Description |
|---|---|---|---|---|
customUid | string | Yes | - | Supported only for standard app API Key calls. Exact match against the external user ID ( outLinkUid , not tmbId ). Omit to keep full scope or pass to restrict reads, updates, and deletions (max 1024 chars, cannot be empty or null , does not change member identity). minLength: 1; maxLength: 1024 |
Request Examples
Replace YOUR_API_KEY and placeholder IDs before running. Self-hosted users should replace the base URL with <instance>/api .
cURL Example
curl --fail-with-body -X POST "https://cloud.fastgpt.io/api/core/chat/record/getQuote" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
--data-raw '{
"appId": "68ad85a7463006c963799a05",
"chatId": "string",
"chatItemDataId": "item_abc123",
"datasetDataIdList": [
"68ad85a7463006c963799a05"
],
"collectionIdList": [
"68ad85a7463006c963799a06"
]
}'Minimal Valid JSON Body
{
"appId": "68ad85a7463006c963799a05",
"chatId": "string",
"chatItemDataId": "item_abc123",
"datasetDataIdList": ["68ad85a7463006c963799a05"],
"collectionIdList": ["68ad85a7463006c963799a06"]
}Response Schema & Examples
Successful /api/* calls return the standard FastGPT envelope { "code": 200, "statusText": "", "message": "", "data": ... } , where data matches the 200 schema below (when a payload schema is declared; otherwise refer to the status description for runtime data semantics).
HTTP 200
Successfully returned citation list
Content-Type : application/json
Root Type : Array ( object[] ). Each array item has the following fields:
| Field | Type | Required | Default | Constraints & Description |
|---|---|---|---|---|
_id | string | Yes | - | Data item ID. pattern: ^[0-9a-fA-F]{24}$ |
q | string | Yes | - | Primary chunk content / question |
a | string | No | - | Supplementary answer / text |
imagePreivewUrl | string | No | - | Image preview URL |
history | object[] | No | - | Legacy snapshot flag |
history[].q | string | Yes | - | Primary chunk content / question |
history[].a | string | No | - | Supplementary answer / text |
history[].imageId | string | No | - | Image ID |
history[].updateTime | string | Yes | - | Update time |
updateTime | string | Yes | - | Update time |
index | integer | Yes | - | Chunk index. min: 0; max: 9007199254740991 |
updated | boolean | No | - | Whether the chunk has been updated since citation |
Last updated