Administration API

Auto-generated from codebase analysis

This section documents the Administration API endpoints.

GET Endpoints

GET /llm-parameters

Get LLM parameters configuration

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/llm-parameters" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /cache-settings

Get cache settings configuration

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/cache-settings" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /feature-settings

Get feature flag settings and available features

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/feature-settings" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /user-feature-access

Check if user has access to user-level feature overrides

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/user-feature-access" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /user-feature-overrides

Get user's feature overrides and effective settings (datalinx.ai org only)

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/user-feature-overrides" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /github-config

Get GitHub configuration

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/github-config" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /users

List all users in the organization

Required Permissions: org.admin

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/users" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /roles

List all roles in the organization

Required Permissions: org.admin

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/roles" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /permissions

List all available permissions

Required Permissions: org.admin

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/permissions" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /system-info

Get system information including deployment version for super admins

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/system-info" \
  -H "Authorization: Bearer YOUR_TOKEN"

GET /get-llm-mode

Get current LLM mode from sys.argv.

Example Request

curl -X GET "https://your-instance.datalinx.ai/api/get-llm-mode" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST Endpoints

POST /llm-parameters

Save LLM parameters configuration

Parameters

Name	Type	Required	Description
input_data	LLMParametersInput	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/llm-parameters" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /cache-settings

Save cache settings configuration and clear caches when settings toggle.

Parameters

Name	Type	Required	Description
input_data	CacheSettingsInput	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/cache-settings" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /feature-settings

Save feature flag settings

Parameters

Name	Type	Required	Description
input_data	FeatureSettingsInput	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/feature-settings" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /user-feature-overrides

Save user's feature overrides (datalinx.ai org only)

Parameters

Name	Type	Required	Description
input_data	UserFeatureOverridesInput	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/user-feature-overrides" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /github-config

Save GitHub configuration

Parameters

Name	Type	Required	Description
input_data	GitHubConfigInput	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/github-config" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /github-test

Test GitHub connection

Parameters

Name	Type	Required	Description
input_data	GitHubConfigInput	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/github-test" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /users

Create a new user in the organization

Required Permissions: org.admin

Parameters

Name	Type	Required	Description
input_data	CreateUserInput	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/users" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /roles

Create a new role

Required Permissions: org.admin

Parameters

Name	Type	Required	Description
input_data	CreateRoleInput	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/roles" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /setup-environment

Setup a complete new environment with org, user, workspace, data source, schema, and mapping.

Parameters

Name	Type	Required	Description
setup_request	EnvironmentSetupRequest	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/setup-environment" \
  -H "Authorization: Bearer YOUR_TOKEN"

POST /set-llm-mode

Set LLM mode by manipulating sys.argv and resetting LLM manager.

Parameters

Name	Type	Required	Description
mode_request	SetLLMModeRequest	Yes

Example Request

curl -X POST "https://your-instance.datalinx.ai/api/set-llm-mode" \
  -H "Authorization: Bearer YOUR_TOKEN"

PUT Endpoints

PUT /users/{user_id}

Update user information

Required Permissions: org.admin

Parameters

Name	Type	Required	Description
user_id	str	Yes
input_data	UpdateUserInput	Yes

Example Request

curl -X PUT "https://your-instance.datalinx.ai/api/users/{user_id}" \
  -H "Authorization: Bearer YOUR_TOKEN"

PUT /users/{user_id}/password

Set password for a user (superadmin only)

Parameters

Name	Type	Required	Description
user_id	str	Yes
input_data	SetUserPasswordInput	Yes

Example Request

curl -X PUT "https://your-instance.datalinx.ai/api/users/{user_id}/password" \
  -H "Authorization: Bearer YOUR_TOKEN"

PUT /users/{user_id}/roles

Update user's role assignments

Required Permissions: org.admin

Parameters

Name	Type	Required	Description
user_id	str	Yes
input_data	UpdateUserRolesInput	Yes

Example Request

curl -X PUT "https://your-instance.datalinx.ai/api/users/{user_id}/roles" \
  -H "Authorization: Bearer YOUR_TOKEN"

PUT /roles/{role_id}

Update role information

Required Permissions: org.admin

Parameters

Name	Type	Required	Description
role_id	int	Yes
input_data	UpdateRoleInput	Yes

Example Request

curl -X PUT "https://your-instance.datalinx.ai/api/roles/{role_id}" \
  -H "Authorization: Bearer YOUR_TOKEN"

PUT /roles/{role_id}/permissions

Update role permissions

Required Permissions: org.admin

Parameters

Name	Type	Required	Description
role_id	int	Yes
input_data	UpdateRolePermissionsInput	Yes

Example Request

curl -X PUT "https://your-instance.datalinx.ai/api/roles/{role_id}/permissions" \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE Endpoints

DELETE /user-feature-overrides

Clear all user's feature overrides (datalinx.ai org only)

Example Request

curl -X DELETE "https://your-instance.datalinx.ai/api/user-feature-overrides" \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE /users/{user_id}

Delete a user from the organization

Required Permissions: org.admin

Parameters

Name	Type	Required	Description
user_id	str	Yes

Example Request

curl -X DELETE "https://your-instance.datalinx.ai/api/users/{user_id}" \
  -H "Authorization: Bearer YOUR_TOKEN"

DELETE /roles/{role_id}

Delete a role

Required Permissions: org.admin

Parameters

Name	Type	Required	Description
role_id	int	Yes

Example Request

curl -X DELETE "https://your-instance.datalinx.ai/api/roles/{role_id}" \
  -H "Authorization: Bearer YOUR_TOKEN"