/bff/post/author-filter-list

Returns every distinct main author (content__post.main_author_id) that currently owns at least one non-deleted post in the organisation, together with the count of posts they main-author and their email (nullable — used to disambiguate homonyms in the filter label). Sorted by postCount DESC so the most prolific writers surface first. Feeds the "Autor" filter chip on the /post admin grid — small set by design (typical org has <20 authors), so no pagination.

PostgetBffPostAuthor-filter-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

Author shop__contact.external_id (16-char string). Pass to /list?mainAuthorId=…

Example71E58E5SjdZN6ut3

namestringRequired

Display name (first_name last_name). Falls back to id when both are empty.

ExampleJan Barášek

emailstringOptional

Author contact email (shop__contact.email). Omitted when the contact row has no email set (nullable since the 2026-06-10 identity refactor). Used by the admin grid to disambiguate homonyms — two people literally named "Jan Novák" get their emails appended to the option label so the selectbox stays unambiguous.

Examplejan.barasek@example.com

postCountnumberRequired

Count of non-deleted posts where this contact is the main_author_id.

Example12

Response example

application/json

{
  "items": [
    {
      "id": "71E58E5SjdZN6ut3",
      "name": "Jan Barášek",
      "email": "jan.barasek@example.com",
      "postCount": 12
    }
  ]
}

Request example

GET /bff/post/author-filter-list

get

curl -X GET "https://api.bizkithub.com/bff/post/author-filter-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