CallaboDevelopersBeta
ドキュメントメニュー

REST API

チーム

ワークスペースのチームと所属メンバーを取得します。

GET/v2/workspaces/{slug}/teams

チームリストを見る

ワークスペースのチームを検索し、ページ単位で取得します。

パラメータ

  • slug必須stringpath
    ワークスペーススラッグ
  • offsetintegerqueryデフォルト 0
    最初に返却する項目の0始まりのオフセットです。
  • limitintegerqueryデフォルト 20
    返却する項目の最大数です。
  • querystring | nullquery
    チーム名に適用する検索語です。
  • member_idinteger | nullquery
    指定したメンバーが所属するチームのみを返します。

リクエスト例

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

成功レスポンス

レスポンス本文

  • items必須V2Team[]
    チームの一覧です。
  • id必須integer
    チームの識別子です。
  • name必須string
    チーム名です。
  • emailstring | null
    チームのメールアドレスです。
  • default_transcribe_language必須TranscribeLanguageForTeam
    チームのデフォルト文字起こし言語です。
  • request_insight_extract_type必須TeamInsightExtractType
    チームのデフォルトインサイト生成タイプです。
  • default_custom_insight_template_idinteger | null
    チームのデフォルトカスタムインサイトテンプレート識別子です。
  • keywords必須string[]
    チームのデフォルトキーワード一覧です。
  • member_count必須integer
    チームに所属するメンバー数です。
  • record_count必須integer
    チームに関連付けられたレコード数です。
  • created_at必須string (date-time)
    チームの作成日時です。
  • page必須V2Pagination
    チーム一覧のページ情報です。
  • offset必須integer
    最初に返却する項目の0始まりのオフセットです。
  • limit必須integer
    指定された最大項目数です。
  • total必須integer
    条件に一致する項目の総数です。

レスポンス例

{
  "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
  }
}

エラー

ステータスエラーコード説明
401UNAUTHORIZED未認証のリクエスト
402FEATURE_NOT_AVAILABLEサブスクリプション機能を利用できません
403FORBIDDENリクエスト元の権限が不足しています
404WORKSPACE_NOT_FOUND存在しません
422VALIDATION_ERROR処理できないコンテンツ
429RATE_LIMIT_EXCEEDEDリクエスト上限超過詳細
GET/v2/workspaces/{slug}/teams/{team_id}

Team詳細検索

チームの詳細情報とメンバー数・レコード数を取得します。

パラメータ

  • team_id必須integerpath
    チームの識別子です。
  • slug必須stringpath
    ワークスペーススラッグ

リクエスト例

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

成功レスポンス

レスポンス本文

  • id必須integer
    チームの識別子です。
  • name必須string
    チーム名です。
  • emailstring | null
    チームのメールアドレスです。
  • default_transcribe_language必須TranscribeLanguageForTeam
    チームのデフォルト文字起こし言語です。
  • request_insight_extract_type必須TeamInsightExtractType
    チームのデフォルトインサイト生成タイプです。
  • default_custom_insight_template_idinteger | null
    チームのデフォルトカスタムインサイトテンプレート識別子です。
  • keywords必須string[]
    チームのデフォルトキーワード一覧です。
  • member_count必須integer
    チームに所属するメンバー数です。
  • record_count必須integer
    チームに関連付けられたレコード数です。
  • created_at必須string (date-time)
    チームの作成日時です。

レスポンス例

{
  "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"
}

エラー

ステータスエラーコード説明
401UNAUTHORIZED未認証のリクエスト
403FORBIDDENリクエスト元の権限が不足しています
404TEAM_NOT_FOUND, WORKSPACE_NOT_FOUND存在しません
422VALIDATION_ERROR処理できないコンテンツ
429RATE_LIMIT_EXCEEDEDリクエスト上限超過詳細
GET/v2/workspaces/{slug}/teams/{team_id}/members

Team member リストを見る

チームに所属するメンバーとロール情報をページ単位で取得します。

パラメータ

  • team_id必須integerpath
    チームの識別子です。
  • slug必須stringpath
    ワークスペーススラッグ
  • offsetintegerqueryデフォルト 0
    最初に返却する項目の0始まりのオフセットです。
  • limitintegerqueryデフォルト 20
    返却する項目の最大数です。

リクエスト例

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

成功レスポンス

レスポンス本文

  • items必須V2TeamMember[]
    チームメンバーの一覧です。
  • id必須integer
    チームメンバーシップの識別子です。
  • team_id必須integer
    チームの識別子です。
  • member_id必須integer
    ワークスペースメンバーの識別子です。
  • member必須V2TeamMemberSummary
    チームに所属するメンバーの情報です。
  • base_workspace_role必須BaseWorkspaceRole
    メンバーのワークスペースにおけるデフォルトロールです。
  • workspace_role_ids必須integer[]
    メンバーに割り当てられたワークスペースのカスタムロール識別子一覧です。
  • base_role必須BaseTeamRole
    メンバーのチームにおけるデフォルトロールです。
  • roles必須V2TeamRole[]
    メンバーに割り当てられたチームのカスタムロール一覧です。
  • team_permissions必須object
    チームロールの組み合わせから算出された権限です。
  • page必須V2Pagination
    チームメンバー一覧のページ情報です。
  • offset必須integer
    最初に返却する項目の0始まりのオフセットです。
  • limit必須integer
    指定された最大項目数です。
  • total必須integer
    条件に一致する項目の総数です。

レスポンス例

{
  "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
  }
}

エラー

ステータスエラーコード説明
401UNAUTHORIZED未認証のリクエスト
403FORBIDDENリクエスト元の権限が不足しています
404TEAM_NOT_FOUND, WORKSPACE_NOT_FOUND存在しません
422VALIDATION_ERROR処理できないコンテンツ
429RATE_LIMIT_EXCEEDEDリクエスト上限超過詳細
© 2026 Return Zero, Inc.