Platform

List the organisation’s teams

The organisation’s named sets of people — «Amministrazione», «Commerciale» — the labels work is routed to, with how many members each has. detailed adds the membership ids and, for an organisation admin ONLY — through a credential that carries members:manage — the permissions the team confers on everyone in it; anybody else gets permissions: null, which means «not visible to you» and never «grants nothing». It never returns names or addresses: call custodo_list_members for the people.

Examples

  • Quali team ci sono? GET /api/v1/rest/teams
  • Show the retired teams too GET /api/v1/rest/teams?include_inactive=true
  • Which permissions does each team give? GET /api/v1/rest/teams?response_format=detailed
get/api/v1/rest/teams

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/teams
  • Auth: HTTP bearer

Query parameters

include_inactiveboolean

true also lists retired teams. A retired team confers nothing and appears in no picker.

response_format'concise' | 'detailed'

concise (default) returns the fields you need to answer a question; detailed adds related records and costs more context.

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.