tenants

tenants, members, seats, groups, email domains, invite links

2 operations — tenants, members, seats, groups, email domains, invite links

GET /api/v1/tenants

tenantsGetApiV1Tenants

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

  • 호출 권한: platform_admin (RequirePlatformAdmin middleware — 일반 사용자는 403).
  • Phase 1: 페이징 미지원 — 응답은 항상 전체.
  • 부수 효과 없음 (read-only).
LanguageCall
nodenot in @ax-hub/sdk — use @ax-hub/admin-sdk tenants.list in the ops package @ax-hub/admin-sdk
goclient.Tenants().TenantsGetApiV1Tenants(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})
javaclient.tenants().tenantsGetApiV1Tenants(pathParams, query, body) — async: tenantsGetApiV1TenantsAsync(…) → CompletableFuture
kotlinclient.tenants.tenantsGetApiV1Tenants(pathParams, query, body) — suspend
pythonclient.tenants.tenants_get_api_v1_tenants(path_params=…, query=…, body=…) — AsyncAxHubClient awaits the same name
rubyclient.tenants.tenants_get_api_v1_tenants(path_params: …, query: …, body: …)
genericrequest("tenantsGetApiV1Tenants", pathParams, query, body)

Response — 200 · 테넌트 목록

NameTypeDescription
itemsarray<object>
nextCursor (wire: next_cursor)string
totalinteger

Error statuses: 401 403 500Error handling

GET /api/v1/tenants/{tenantID}

tenantsGetApiV1TenantsByTenantID

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

  • 호출 권한: 자기 테넌트 멤버만 (RequireTenantMemberOnPath). SaaS 격리 — 다른 테넌트 사용자에겐 조직 메타데이터도 노출 X.
  • path 의 tenantID 가 UUID 형식이 아니면 400.
  • 부수 효과 없음 (read-only).
LanguageCall
nodesdk.tenants.get(…) — resource model — see the package's TypeScript definitions for arguments and return types
goclient.Tenants().TenantsGetApiV1TenantsByTenantID(ctx, axhub.OperationParams{PathParams: …, Query: …, Body: …})
javaclient.tenants().tenantsGetApiV1TenantsByTenantID(pathParams, query, body) — async: tenantsGetApiV1TenantsByTenantIDAsync(…) → CompletableFuture
kotlinclient.tenants.tenantsGetApiV1TenantsByTenantID(pathParams, query, body) — suspend
pythonclient.tenants.tenants_get_api_v1_tenants_by_tenant_id(path_params=…, query=…, body=…) — AsyncAxHubClient awaits the same name
rubyclient.tenants.tenants_get_api_v1_tenants_by_tenant_id(path_params: …, query: …, body: …)
genericrequest("tenantsGetApiV1TenantsByTenantID", pathParams, query, body)

Path parameters — pass via pathParams

NameTypeDescription
tenantID requiredstring테넌트 UUID

Response — 200 · 테넌트

NameTypeDescription
adminEmail (wire: admin_email)stringAdminEmail 은 가장 오래된 active tenant_admin 의 email (없으면 null). 관리 UI 의 owner 컬럼 표시용 — 결정적 단일 admin (created_at ASC) 으로 페이지로드 간 안정.
appCount (wire: app_count)integerAppCount 는 not-soft-deleted 앱의 수. enrich 불가 시 0.
createdAt (wire: created_at)stringCreatedAt 은 생성 시각.
deletedAt (wire: deleted_at)stringDeletedAt 은 soft delete 시각 (활성 테넌트는 null).
descriptionstringDescription 은 테넌트 설명 (없으면 null).
iconUrl (wire: icon_url)stringIconURL 은 테넌트 아이콘 이미지 URL (없으면 null).
idstringID 는 테넌트 UUID.
memberCount (wire: member_count)integerMemberCount 는 active 멤버십 (is_active=true) 의 수. enrich 불가 시 0.
namestringName 은 사람이 읽는 표시 이름.
slugstringSlug 는 URL 식별자. [a-z][a-z0-9_]*[a-z0-9] 패턴, 전 시스템에서 unique.
updatedAt (wire: updated_at)stringUpdatedAt 은 마지막 수정 시각.

Error statuses: 400 401 403 404 500Error handling