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_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_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.