BizKitHub
DocsAPI ReferenceIssue/bff/issue/participants
getIssueAdmin BFF

/bff/issue/participants

Returns every contact linked to the issue via pm__issue_participant, deduplicated across roles. selfIsFollowing tells the UI whether to render the "Follow" or "Unfollow" button for the current operator. canUnfollow on each row is true only for the operator's own watcher row — reporter/assignee/commenter/mentioned rows can't be unfollowed through this endpoint (change the assignee / delete the comment / etc. instead).

IssuegetBffIssueParticipants

Parameters

1 query

Query parameters

· 1
issueKeystringRequired

Issue key.

ExampleBIZKIT-22

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
contactIdnumberRequired

Internal contact ID.

externalIdstring | nullRequired
One of 2:
Variant 1
string

Public shop__contact.external_id.

Variant 2
null
fullNamestringRequired

Display name (falls back to e-mail, then "#id").

emailstring | nullRequired
One of 2:
Variant 1
string

Contact e-mail (null for phone-only / anonymised).

Variant 2
null
avatarUrlstring | nullRequired
One of 2:
Variant 1
string

Avatar URL resolved through selectContactAvatarBlobMap (contact → user canonical).

Variant 2
null
roles"reporter" | "assignee" | "commenter" | "watcher" | "mentioned"[]Required
Each array item:
"reporter" | "assignee" | "commenter" | "watcher" | "mentioned"
firstSeenDatestringRequired

ISO timestamp — earliest role attach.

lastSeenDatestringRequired

ISO timestamp — most recent role activity.

canUnfollowbooleanRequired

True only when the row IS the operator's own watcher row (and thus removable via /bff/issue/unfollow).

isSelfbooleanRequired

True when the row is the operator.

selfIsFollowingbooleanRequired

Operator is currently a watcher on this issue.

selfCanFollowbooleanRequired

Operator has a resolved contact and can follow (false for identityless-sessions).

Response example

application/json
{
  "items": [
    {
      "contactId": 0,
      "fullName": "example_fullName",
      "roles": [],
      "firstSeenDate": "example_firstSeenDate",
      "lastSeenDate": "example_lastSeenDate",
      "canUnfollow": false,
      "isSelf": false
    }
  ],
  "selfIsFollowing": false,
  "selfCanFollow": false
}

Request example

GET /bff/issue/participants

get
curl -X GET "https://api.bizkithub.com/bff/issue/participants?issueKey=BIZKIT-22" \
  -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