Trovacast

Platform

Teams and members

Read the project’s teams and seats — the ids call queues and BRIDGE calls take — without the console.

GET /v1/teams (teams:read) lists the project’s teams and GET /v1/members (members:read) its seats. Both are read-only — teams and seats are managed in the console — newest first, with the usual cursor pages. A team’s id is what POST /v1/queues takes as teamId; a member’s id is a queue member’s membershipId and a BRIDGE call’s bridge.to.agentMembershipId.

Members

Every seat but a removed one: its display name, its email masked (the first letter and the domain — never the address), its status (invited, active, suspended), its organization-wide roles, the active teams it is on (teamIds, and teams with its role on each) and — for someone who uses the call-center desk — its presence (available, reserved, busy, after_call_work, break, offline, and since when). Narrow with ?teamId= and ?status=. Teams and seats are configuration, not traffic: a test key reads the same rows as a live key, except that every presence reads null to it — a member’s desk state is a live person’s, which a test key never reads.

200 (json)
{
  "data": [
    {
      "object": "member",
      "id": "6c5b4a39-2817-4f6e-9d5c-4b3a29180716",
      "displayName": "Asha Menon",
      "email": "a•••@example.com",
      "status": "active",
      "roles": [],
      "teamIds": [
        "0f1e2d3c-4b5a-4968-8778-695a4b3c2d1e"
      ],
      "teams": [
        {
          "teamId": "0f1e2d3c-4b5a-4968-8778-695a4b3c2d1e",
          "roles": [
            "agent"
          ]
        }
      ],
      "presence": {
        "status": "available",
        "since": "2026-11-07T09:00:00.000Z"
      },
      "joinedAt": "2026-11-07T09:00:00.000Z",
      "createdAt": "2026-11-07T09:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Teams

Every team of the project, active or not, with memberCount — its active members.

200 (json)
{
  "data": [
    {
      "object": "team",
      "id": "0f1e2d3c-4b5a-4968-8778-695a4b3c2d1e",
      "name": "Support",
      "description": null,
      "active": true,
      "memberCount": 4,
      "createdAt": "2026-11-07T09:00:00.000Z",
      "updatedAt": "2026-11-07T09:00:00.000Z"
    }
  ],
  "nextCursor": null
}