CallaboDevelopersBeta
Docs menu

REST API

Teams

Read teams in a workspace and their members.

GET/v2/workspaces/{slug}/teams

Team list search

Search and list workspace teams with pagination.

Parameters

  • slugRequiredstringpath
    Workspace slug
  • offsetintegerqueryDefault 0
    Zero-based offset of the first returned item.
  • limitintegerqueryDefault 20
    Maximum number of items returned.
  • querystring | nullquery
    Search term applied to team names.
  • member_idinteger | nullquery
    Return only teams to which the specified member belongs.

Request example

curl --request GET \
  --url "https://api.callabo.ai/v2/workspaces/your-workspace/teams" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $CALLABO_PAT"

Success responses

Response body

  • itemsRequiredV2Team[]
    Teams.
  • idRequiredinteger
    Team identifier.
  • nameRequiredstring
    Team name.
  • emailstring | null
    Team email address.
  • default_transcribe_languageRequiredTranscribeLanguageForTeam
    Default transcription language for the team.
  • request_insight_extract_typeRequiredTeamInsightExtractType
    Default insight generation type for the team.
  • default_custom_insight_template_idinteger | null
    Default custom insight template identifier for the team.
  • keywordsRequiredstring[]
    Default team keywords.
  • member_countRequiredinteger
    Number of members in the team.
  • record_countRequiredinteger
    Number of records associated with the team.
  • created_atRequiredstring (date-time)
    Date and time when the team was created.
  • pageRequiredV2Pagination
    Team pagination information.
  • offsetRequiredinteger
    Zero-based offset of the first returned item.
  • limitRequiredinteger
    Requested maximum number of items.
  • totalRequiredinteger
    Total number of matching items.

Response example

{
  "items": [
    {
      "id": 1,
      "name": "Example",
      "default_transcribe_language": "inherit",
      "request_insight_extract_type": "inherit",
      "keywords": [
        "string"
      ],
      "member_count": 1,
      "record_count": 1,
      "created_at": "2026-08-27T03:00:00Z"
    }
  ],
  "page": {
    "offset": 1,
    "limit": 1,
    "total": 1
  }
}

Errors

StatusError codeDescription
401UNAUTHORIZEDUnauthenticated request
402FEATURE_NOT_AVAILABLESubscription feature unavailable
403FORBIDDENInsufficient requester permissions
404WORKSPACE_NOT_FOUNDNot found
422VALIDATION_ERRORUnprocessable content
429RATE_LIMIT_EXCEEDEDRequest limit exceededLearn more
GET/v2/workspaces/{slug}/teams/{team_id}

Team Detailed inquiry

Retrieve team details and member and record counts.

Parameters

  • team_idRequiredintegerpath
    Team identifier.
  • slugRequiredstringpath
    Workspace slug

Request example

curl --request GET \
  --url "https://api.callabo.ai/v2/workspaces/your-workspace/teams/1" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $CALLABO_PAT"

Success responses

Response body

  • idRequiredinteger
    Team identifier.
  • nameRequiredstring
    Team name.
  • emailstring | null
    Team email address.
  • default_transcribe_languageRequiredTranscribeLanguageForTeam
    Default transcription language for the team.
  • request_insight_extract_typeRequiredTeamInsightExtractType
    Default insight generation type for the team.
  • default_custom_insight_template_idinteger | null
    Default custom insight template identifier for the team.
  • keywordsRequiredstring[]
    Default team keywords.
  • member_countRequiredinteger
    Number of members in the team.
  • record_countRequiredinteger
    Number of records associated with the team.
  • created_atRequiredstring (date-time)
    Date and time when the team was created.

Response example

{
  "id": 1,
  "name": "Example",
  "default_transcribe_language": "inherit",
  "request_insight_extract_type": "inherit",
  "keywords": [
    "string"
  ],
  "member_count": 1,
  "record_count": 1,
  "created_at": "2026-08-27T03:00:00Z"
}

Errors

StatusError codeDescription
401UNAUTHORIZEDUnauthenticated request
403FORBIDDENInsufficient requester permissions
404TEAM_NOT_FOUND, WORKSPACE_NOT_FOUNDNot found
422VALIDATION_ERRORUnprocessable content
429RATE_LIMIT_EXCEEDEDRequest limit exceededLearn more
GET/v2/workspaces/{slug}/teams/{team_id}/members

Team member list search

List members belonging to the team and their role information with pagination.

Parameters

  • team_idRequiredintegerpath
    Team identifier.
  • slugRequiredstringpath
    Workspace slug
  • offsetintegerqueryDefault 0
    Zero-based offset of the first returned item.
  • limitintegerqueryDefault 20
    Maximum number of items returned.

Request example

curl --request GET \
  --url "https://api.callabo.ai/v2/workspaces/your-workspace/teams/1/members" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer $CALLABO_PAT"

Success responses

Response body

  • itemsRequiredV2TeamMember[]
    Team members.
  • idRequiredinteger
    Team membership identifier.
  • team_idRequiredinteger
    Team identifier.
  • member_idRequiredinteger
    Workspace member identifier.
  • memberRequiredV2TeamMemberSummary
    Information about a member of the team.
  • base_workspace_roleRequiredBaseWorkspaceRole
    Member's default workspace role.
  • workspace_role_idsRequiredinteger[]
    Identifiers of custom workspace roles assigned to the member.
  • base_roleRequiredBaseTeamRole
    Member's default team role.
  • rolesRequiredV2TeamRole[]
    Custom team roles assigned to the member.
  • team_permissionsRequiredobject
    Permissions calculated from the combination of team roles.
  • pageRequiredV2Pagination
    Team member pagination information.
  • offsetRequiredinteger
    Zero-based offset of the first returned item.
  • limitRequiredinteger
    Requested maximum number of items.
  • totalRequiredinteger
    Total number of matching items.

Response example

{
  "items": [
    {
      "id": 1,
      "team_id": 1,
      "member_id": 1,
      "member": {
        "id": 1,
        "user_id": 1,
        "email": "developer@example.com",
        "name": "Example"
      },
      "base_workspace_role": "workspace_manager",
      "workspace_role_ids": [
        1
      ],
      "base_role": "manager",
      "roles": [
        {
          "id": 1,
          "name": "Example",
          "is_system_role": true,
          "permissions": [
            {
              "resource": "member_management",
              "effect": "allow"
            }
          ]
        }
      ],
      "team_permissions": {}
    }
  ],
  "page": {
    "offset": 1,
    "limit": 1,
    "total": 1
  }
}

Errors

StatusError codeDescription
401UNAUTHORIZEDUnauthenticated request
403FORBIDDENInsufficient requester permissions
404TEAM_NOT_FOUND, WORKSPACE_NOT_FOUNDNot found
422VALIDATION_ERRORUnprocessable content
429RATE_LIMIT_EXCEEDEDRequest limit exceededLearn more
© 2026 Return Zero, Inc.