Back to Fastgpt

API Documentation Introduction

document/content/openapi/intro.en.mdx

4.15.12.2 KB
Original Source

Starting with 4.15.0, FastGPT API documentation is generated automatically with zod-openapi (some legacy endpoints have not been migrated, so they are not shown). You can view the latest endpoint status by opening the API documentation URL. The manually edited endpoint descriptions in the left sidebar of this documentation are no longer updated.

FastGPT API documentation is split into two sets:

  • Dev API: all development APIs. Not every endpoint can be called with an API Key.
  • System OpenAPI: all system public endpoints, callable with a system API Key.

API Documentation URL

endpoint is your FastGPT access URL. Append the corresponding path to open the documentation.

  • Dev API: {{endpoint}}/apidoc/devapi
  • System OpenAPI: {{endpoint}}/apidoc/systemopenapi

Cloud API Documentation URL

Dev API:

System OpenAPI

Usage Notes

FastGPT OpenAPI endpoints let you authenticate with an API Key to operate related FastGPT services and resources, such as calling app chat endpoints, uploading Knowledge Base data, and running search tests. For compatibility and security reasons, not all endpoints can be accessed with an API Key.

How to Get an API Key

You can find API Keys in two places:

  1. Account - API Keys
  2. App - Publish Channels - API Access

API Key Scope

An API Key acts as the current account's access credential within the current team. In other words, any resource the account can access in that team can also be operated through the API Key.

How to Find the BaseURL

Note: BaseURL is not an endpoint URL. It is the root URL for all endpoints, and requesting the BaseURL directly does nothing.

Basic Configuration

In OpenAPI, all endpoints authenticate through Header.Authorization.

baseUrl: "http://localhost:3000/api"
headers: {
    Authorization: "Bearer {{apikey}}"
}