Client Tools

PicFast provides a flat upload endpoint at /api/v1/flat/upload that returns a clean JSON response — ideal for third-party upload clients. All tools below use this same endpoint.

PicGo / PicList

Install PicGo or PicList, then install the web-uploader plugin from the plugin settings.
In image host settings, choose Custom Web Image Host and paste the config below.

{
  "picBed": {
    "uploader": "picgo-plugin-web-uploader",
    "picgo-plugin-web-uploader": {
      "url": "https://picfast.example.com/api/v1/flat/upload",
      "paramName": "file",
      "jsonPath": "url",
      "customHeader": "{\"Authorization\": \"Bearer <YOUR_API_TOKEN>\"}"
    }
  }
}

uPic

In uPic, choose Custom as the image host and fill in:

Field	Value
URL	`https://picfast.example.com/api/v1/flat/upload`
Method	`POST`
File Field	`file`
Header	`Authorization: Bearer <YOUR_API_TOKEN>`
URL Path	`["url"]`
Domain	`https://picfast.example.com`

Dropshare

In Dropshare, choose Custom API connection:

Field	Value
Upload URL	`https://picfast.example.com/api/v1/flat/upload`
Method	`POST`
Content Type	`multipart/form-data`
Form Field	`file`
Header	`{"Authorization": "Bearer <YOUR_API_TOKEN>"}`
Response Content Type	`JSON`
URL to file	`%url%`

 Obsidian
 Install the community plugin Image auto upload and select PicGo as the upload service. Images pasted into notes are automatically uploaded to PicFast and replaced with the returned URL.
 API token
 Create an API token in the PicFast admin console under Settings → API Tokens. Tokens are prefixed img_ and support scoped permissions (e.g. upload-only). Use the token in the Authorization: Bearer header for all tools above.