tenants

테넌트·멤버·seat·그룹·email-domains·invite-links

3 operations — 테넌트·멤버·seat·그룹·email-domains·invite-links

tenantsGetApiV1Tenants

전체 테넌트 목록을 반환한다.

언어	호출
node	`@ax-hub/sdk` 미제공 — 운영 패키지 `@ax-hub/admin-sdk` 의 `@ax-hub/admin-sdk tenants.list` 사용
go	`client.Tenants().TenantsGetApiV1Tenants(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.tenants().tenantsGetApiV1Tenants(pathParams, query, body)` — 비동기: `tenantsGetApiV1TenantsAsync(…)` → CompletableFuture
kotlin	`client.tenants.tenantsGetApiV1Tenants(pathParams, query, body)` — suspend
python	`client.tenants.tenants_get_api_v1_tenants(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.tenants.tenants_get_api_v1_tenants(path_params: …, query: …, body: …)`
공통	`request("tenantsGetApiV1Tenants", pathParams, query, body)`

응답 — 200 · 테넌트 목록

에러 status: 401 403 500 — 에러 처리

tenantsGetApiV1TenantsByTenantID

테넌트 UUID 로 단건 조회 (id / slug / name / icon / description).

호출 권한: 자기 테넌트 멤버만 (RequireTenantMemberOnPath). SaaS 격리 — 다른 테넌트 사용자에겐 조직 메타데이터도 노출 X.
path 의 tenantID 가 UUID 형식이 아니면 400.
부수 효과 없음 (read-only).

언어	호출
node	`sdk.tenants.get(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Tenants().TenantsGetApiV1TenantsByTenantID(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.tenants().tenantsGetApiV1TenantsByTenantID(pathParams, query, body)` — 비동기: `tenantsGetApiV1TenantsByTenantIDAsync(…)` → CompletableFuture
kotlin	`client.tenants.tenantsGetApiV1TenantsByTenantID(pathParams, query, body)` — suspend
python	`client.tenants.tenants_get_api_v1_tenants_by_tenant_id(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.tenants.tenants_get_api_v1_tenants_by_tenant_id(path_params: …, query: …, body: …)`
공통	`request("tenantsGetApiV1TenantsByTenantID", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

응답 — 200 · 테넌트

이름	타입	설명
`adminEmail` (wire: `admin_email`)	string	AdminEmail 은 가장 오래된 active tenant_admin 의 email (없으면 null). 관리 UI 의 owner 컬럼 표시용 — 결정적 단일 admin (created_at ASC) 으로 페이지로드 간 안정.
`appCount` (wire: `app_count`)	integer	AppCount 는 not-soft-deleted 앱의 수. enrich 불가 시 0.
`createdAt` (wire: `created_at`)	string	CreatedAt 은 생성 시각.
`deletedAt` (wire: `deleted_at`)	string	DeletedAt 은 soft delete 시각 (활성 테넌트는 null).
`description`	string	Description 은 테넌트 설명 (없으면 null).
`iconUrl` (wire: `icon_url`)	string	IconURL 은 테넌트 아이콘 이미지 URL (없으면 null).
`id`	string	ID 는 테넌트 UUID.
`memberCount` (wire: `member_count`)	integer	MemberCount 는 active 멤버십 (is_active=true) 의 수. enrich 불가 시 0.
`name`	string	Name 은 사람이 읽는 표시 이름.
`slug`	string	Slug 는 URL 식별자. `[a-z][a-z0-9_]*[a-z0-9]` 패턴, 전 시스템에서 unique.
`updatedAt` (wire: `updated_at`)	string	UpdatedAt 은 마지막 수정 시각.

에러 status: 400 401 403 404 500 — 에러 처리

tenantsGetApiV1TenantsByTenantIDOrgDirectory

회사 IdP(Okta/Azure)가 SCIM 으로 밀어넣은 조직 구조를 부서(그룹)→인원으로 반환한다.

언어	호출
node	`sdk.tenants.orgDirectory(…)` — 리소스 모델 — 인자·반환 타입은 패키지의 TypeScript 정의 참조
go	`client.Tenants().TenantsGetApiV1TenantsByTenantIDOrgDirectory(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})`
java	`client.tenants().tenantsGetApiV1TenantsByTenantIDOrgDirectory(pathParams, query, body)` — 비동기: `tenantsGetApiV1TenantsByTenantIDOrgDirectoryAsync(…)` → CompletableFuture
kotlin	`client.tenants.tenantsGetApiV1TenantsByTenantIDOrgDirectory(pathParams, query, body)` — suspend
python	`client.tenants.tenants_get_api_v1_tenants_by_tenant_id_org_directory(path_params=…, query=…, body=…)` — AsyncAxHubClient 는 동일명 await
ruby	`client.tenants.tenants_get_api_v1_tenants_by_tenant_id_org_directory(path_params: …, query: …, body: …)`
공통	`request("tenantsGetApiV1TenantsByTenantIDOrgDirectory", pathParams, query, body)`

Path 파라미터 — pathParams 로 전달

이름	타입	설명
`tenantID` 필수	string	테넌트 UUID

응답 — 200 · 부서별 조직도 + 미배정

이름	타입	설명
`departments`	array<object>	Departments 는 테넌트의 모든 그룹(부서)과 소속 인원.
`unassigned`	array<object>	Unassigned 는 어느 부서에도 속하지 않은 인원.

에러 status: 400 401 403 500 — 에러 처리