Import tenants from CSV file
Changed onImport tenants from a CSV file using upsert semantics.
Expected CSV format:
- tenant_key (required): Unique tenant identifier
- tenant_name (optional): Human-readable name
- group_names (optional): Comma-separated list of group names
- Additional columns can be mapped to attributes via attribute_columns
Creates new tenants and updates existing ones with new name/groups. Groups are added additively (not replaced) and auto-created if needed.
Optionally processes attribute columns: values are validated against attributes.yaml, stored additively, and validation errors are non-fatal.
RLS: Filtered to current client (ClientRLSDB).
Raises: ValidationError: If CSV format is invalid (400) TenantCreationNotAllowedError: If tenancy type is NONE (400)
Request
- Base URLhttps://api.kater.ai
- Auth
- HTTP bearer
- or API key in header X-API-Key
Query parameters
Headers
Request body multipart/form-data
Response
Successful Response
Changes
- breaking
response property
errorslist-of-types was widened by adding typesarrayto media typeapplication/jsonof response400 - breaking
response property
errorslist-of-types was widened by adding typesarrayto media typeapplication/jsonof response401 - breaking
response property
errorslist-of-types was widened by adding typesarrayto media typeapplication/jsonof response422 - info
added the new optional
headerrequest parameterX-Kater-CLI-ID - info
added the new optional
queryrequest parametersource - info
added the new optional request property
- info
added the optional property
to the response with the status
- breaking
- warning
removed the optional property
from the response with the status - info
added the optional property
to the response with the status - info
added the required property
to the response with the status - info
added the required property
to the response with the status - info
added the required property
to the response with the status
- warning