Zum Inhalt

Topic Staff

GET /portfolio/topic/{id}/staff

Returns a compact staff list for one topic.

Parameters

Parameter Type Description
id (path) string Stored institutional topic ID.
apikey string Portfolio API key, if configured; alternatively use X-API-Key.
limit integer Maximum list rows. A positive value enables shared pagination.
offset integer List rows to skip with limit. Defaults to 0; negative values become 0.

Authentication, pagination, and error envelopes are described in Portfolio API Basics. Parameters such as json, filter, columns[], full, and aggregate are not supported unless listed here.

Example Request

1
GET /portfolio/topic/biology/staff?apikey=YOUR_PORTFOLIO_API_KEY

Example Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
  "status": 200,
  "count": 1,
  "data": [
    {
      "id": "665ef1234567890abcdef1234",
      "displayname": "Alex Example",
      "academic_title": "Dr.",
      "position": "Researcher",
      "position_de": "Forschende",
      "firstname": "Alex",
      "lastname": "Example"
    }
  ]
}

The example uses illustrative values. Optional stored or rendered fields may be omitted. Response count is the number of returned list rows before shared pagination.

Returned Fields

Field Description
id Person MongoDB ObjectID as string.
displayname First and last name joined with a space for unit/topic staff; stored display name for project staff.
academic_title, position, position_de Stored academic title and bilingual position.
firstname, lastname Stored name components (unit/topic staff only).

Response Behavior

Matches exact topic membership; excludes is_active=false and hide=true. Rows are sorted by surname ascending. No contact details or profile images are returned.