Technical referenceOfficial documentation11 min readreference-data

FastGPT OpenAPI Endpoint Reference (v4.17.2)

This page lists the 33 endpoints that appear in the FastGPT v4.17.2 OpenAPI documentation (apps, chat and knowledge bases).

This page lists the 33 endpoints that appear in the FastGPT v4.17.2 OpenAPI documentation (apps, chat and knowledge bases). Each path is checked against the v4.17.2 repository for a matching route file under projects/app/src/pages/api/.

MethodEndpoints
DELETE5
GET6
POST20
PUT2

Apps endpoints (2)

MethodPathPurposeDoc sectionRoute in open-source repo
GET/api/proApi/core/app/logs/getTotalDataGet App Overall StatisticsLog APINot found (follow the official docs)
POST/api/proApi/core/app/logs/getChartDataGet App Chart DataLog APINot found (follow the official docs)

Chat endpoints (11)

MethodPathPurposeDoc sectionRoute in open-source repo
POST/api/v1/chat/completionsStart Chat; Continue Interaction; Request PluginStart ChatYes
POST/api/core/chat/history/getHistoriesGet Session ListSession ManagementYes
PUT/api/core/chat/history/updateHistoryUpdate Session Title; Update Session Pin StatusSession ManagementYes
DELETE/api/core/chat/history/delHistoryDelete a SessionSession ManagementYes
DELETE/api/core/chat/history/clearHistoriesClear App SessionsSession ManagementYes
GET/api/core/chat/initGet Session Basic InfoMessage ManagementYes
POST/api/core/chat/record/getPaginationRecordsGet Message ListMessage ManagementYes
GET/api/core/chat/record/getResDataGet Message Run DetailsMessage ManagementYes
DELETE/api/core/chat/record/deleteDelete MessageMessage ManagementYes
POST/api/core/chat/feedback/updateUserFeedbackUpdate Feedback (Like / Dislike)Message ManagementYes
POST/api/core/ai/agent/v2/createQuestionGuideQuestion SuggestionsQuestion SuggestionsYes

Knowledge bases endpoints (20)

MethodPathPurposeDoc sectionRoute in open-source repo
POST/api/core/dataset/createCreate DatasetDatasetYes
POST/api/core/dataset/listGet Dataset ListDatasetYes
GET/api/core/dataset/detailGet Dataset DetailsDatasetYes
DELETE/api/core/dataset/deleteDelete DatasetDatasetYes
POST/api/core/dataset/collection/createCreate Empty Collection/FolderCollectionYes
POST/api/core/dataset/collection/create/textCreate a Text CollectionCollectionYes
POST/api/core/dataset/collection/create/linkCreate a Link CollectionCollectionYes
POST/api/core/dataset/collection/create/localFileCreate a File CollectionCollectionYes
POST/api/core/dataset/collection/create/apiCollectionCreate a Collection from an API Dataset (V1)CollectionYes
POST/api/proApi/core/dataset/collection/create/externalFileUrlCreate an External File Collection (Commercial)CollectionNot found (follow the official docs)
POST/api/core/dataset/collection/listV2Get Collection ListCollectionYes
GET/api/core/dataset/collection/detailGet Collection DetailsCollectionYes
POST/api/core/dataset/collection/updateUpdate Collection InfoCollectionYes
POST/api/core/dataset/collection/deleteDelete CollectionCollectionYes
POST/api/core/dataset/data/pushDataPush Data to Processing QueueDataYes
POST/api/core/dataset/data/v2/listGet Collection Data ListDataYes
GET/api/core/dataset/data/detailGet Single Data DetailsDataYes
PUT/api/core/dataset/data/updateUpdate Single DataDataYes
DELETE/api/core/dataset/data/deleteDelete Single DataDataYes
POST/api/core/dataset/searchTestSearch TestSearch TestYes

How to read it

  1. Paths come from the request examples in the official documentation. The examples use http://localhost:3000; replace it with your deployment address.
  2. When the same path appears several times in the documentation, it is listed once here, and the purpose column lists each section heading where it appears.
  3. "Not found" means the open-source repository has no route file with that name. The endpoint may be served by the commercial edition; check the official documentation and your deployment before calling it.
  4. Authentication, request bodies and response fields are covered in the matching sections of the official OpenAPI documentation.

Scope of this reference

The endpoint list comes from the FastGPT v4.17.2 official OpenAPI documentation and repository tree. Internal endpoints that the documentation does not cover are out of scope. Customised self-hosted deployments follow their own implementation.

Sources