Authentication API
Auto-generated from codebase analysis
This section documents the Authentication API endpoints.
GET Endpoints
GET /organizations
List all available organizations for login selection
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/organizations" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /session
Get current session information
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/session" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /sessions
List all active sessions (admin only)
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/sessions" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /preferences
Get current user's preferences
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/preferences" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /admin/organizations
Super admin: List all organizations
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/admin/organizations" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /admin/users
Super admin: List all users
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/admin/users" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /admin/organizations/{org_id}/workspaces
Super admin: List all workspaces for an organization
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
org_id | str | Yes |
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/admin/organizations/{org_id}/workspaces" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /admin/logs/download
Super admin: Download control plane logs as compressed archive
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/admin/logs/download" \
-H "Authorization: Bearer YOUR_TOKEN"
POST Endpoints
POST /login
Login with username and organization domain
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
login_request | LoginRequest | Yes |
Example Request
curl -X POST "https://your-instance.datalinx.ai/api/login" \
-H "Authorization: Bearer YOUR_TOKEN"
POST /logout
Logout current user
Example Request
curl -X POST "https://your-instance.datalinx.ai/api/logout" \
-H "Authorization: Bearer YOUR_TOKEN"
POST /admin/login
Super admin login endpoint
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
login_request | LoginRequest | Yes |
Example Request
curl -X POST "https://your-instance.datalinx.ai/api/admin/login" \
-H "Authorization: Bearer YOUR_TOKEN"
POST /admin/organizations
Super admin: Create a new organization
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
org_data | Dict[str, Any] | Yes |
Example Request
curl -X POST "https://your-instance.datalinx.ai/api/admin/organizations" \
-H "Authorization: Bearer YOUR_TOKEN"
POST /admin/users
Super admin: Create a new user with password
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
user_data | Dict[str, Any] | Yes |
Example Request
curl -X POST "https://your-instance.datalinx.ai/api/admin/users" \
-H "Authorization: Bearer YOUR_TOKEN"
POST /change-password
Change user password - required on first login with temporary password
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
password_request | ChangePasswordRequest | Yes |
Example Request
curl -X POST "https://your-instance.datalinx.ai/api/change-password" \
-H "Authorization: Bearer YOUR_TOKEN"
PUT Endpoints
PUT /preferences
Update current user's preferences
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
preferences | Dict[str, Any] | Yes |
Example Request
curl -X PUT "https://your-instance.datalinx.ai/api/preferences" \
-H "Authorization: Bearer YOUR_TOKEN"
PUT /admin/organizations/{org_id}
Super admin: Update an organization
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
org_id | str | Yes | |
org_data | Dict[str, Any] | Yes |
Example Request
curl -X PUT "https://your-instance.datalinx.ai/api/admin/organizations/{org_id}" \
-H "Authorization: Bearer YOUR_TOKEN"
PUT /admin/users/{user_id}
Super admin: Update a user
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
user_id | str | Yes | |
user_data | Dict[str, Any] | Yes |
Example Request
curl -X PUT "https://your-instance.datalinx.ai/api/admin/users/{user_id}" \
-H "Authorization: Bearer YOUR_TOKEN"
DELETE Endpoints
DELETE /admin/organizations/{org_id}
Super admin: Delete an organization
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
org_id | str | Yes |
Example Request
curl -X DELETE "https://your-instance.datalinx.ai/api/admin/organizations/{org_id}" \
-H "Authorization: Bearer YOUR_TOKEN"
DELETE /admin/workspaces/{tenant_id}/{workspace_name}
Super admin: Delete a workspace for a specific organization
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
tenant_id | str | Yes | |
workspace_name | str | Yes |
Example Request
curl -X DELETE "https://your-instance.datalinx.ai/api/admin/workspaces/{tenant_id}/{workspace_name}" \
-H "Authorization: Bearer YOUR_TOKEN"
DELETE /admin/users/{user_id}
Super admin: Delete a user
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
user_id | str | Yes |
Example Request
curl -X DELETE "https://your-instance.datalinx.ai/api/admin/users/{user_id}" \
-H "Authorization: Bearer YOUR_TOKEN"