/bff/post/reference-image-list

Returns the org-wide reference image library plus the configured mood prompt and aspect ratio. Used by /settings/posts to render the AI-image management panel and by the per-article gallery view to decide whether the "Generate image" button should be enabled.

PostgetBffPostReference-image-list

Parameters

No parameters required

This endpoint takes no path, query, header or body parameters.

Response schema

1 status code documented

200Success

itemsobject[]Required

Each array item:

idstringRequired

Reference image record id.

isActivebooleanRequired

Whether this image is fed to the generator.

insertedDatestringRequired

When the image was uploaded.

blobTokenstringRequired

Underlying blob token.

downloadUrlstringRequired

Public URL to display the thumbnail.

filenamestring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

sizenumberRequired

contentTypestringRequired

moodPromptstringRequired

Mood prompt injected into every generation request. Empty when not configured.

aspectRatiostringRequired

Aspect ratio the generator uses for post thumbnails. One of "3:2" (default), "16:9", "4:3", "1:1", "9:16".

hasActivebooleanRequired

True if at least one reference image is active.

Response example

application/json

{
  "items": [
    {
      "id": "example_id",
      "isActive": false,
      "insertedDate": "example_insertedDate",
      "blobToken": "example_blobToken",
      "downloadUrl": "example_downloadUrl",
      "size": 0,
      "contentType": "example_contentType"
    }
  ],
  "moodPrompt": "example_moodPrompt",
  "aspectRatio": "example_aspectRatio",
  "hasActive": false
}

Request example

GET /bff/post/reference-image-list

get

curl -X GET "https://api.bizkithub.com/bff/post/reference-image-list" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key