Scope

List Groups

GET/v2/groups

Groups inside ``team_id`` the caller is a member of. ``team_id`` is required — there's no global "all my groups" view here because every downstream call (orchestrations, agent grants) needs a team context anyway, so callers get more useful results by picking the team first.

Query Parameters

team_idstring · uuidrequired

Request

curl --request GET \
  --url https://api.brainbaselabs.com/v2/groups \
  --header 'Authorization: Bearer YOUR_API_KEY'

Response

json

{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba",
      "name": "string",
      "description": "",
      "icon": "string",
      "icon_color": "string"
    }
  ]
}