Admin

Get all tools with pagination

get

Get all tools with pagination

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search tools by name

Default: ""
typeany ofOptional

Tool type: native, custom, or mcp

string · enumOptional

Type of tool.

Possible values:
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/tools

Get all tools

get

Get all tools

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search tools by name or description

Default: ""
typeany ofOptional

Tool type: native, custom, or mcp

string · enumOptional

Type of tool.

Possible values:
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/tools/all

Get MCP tools with pagination

get

Get MCP tools with pagination. Supports search filtering and pagination.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search tools by name or description

Default: ""
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/tools/mcp

Create MCP tool

post

Creates a new MCP tool configuration in AIP service and stores metadata locally. Validates MCP server configuration including authentication and connection details.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

MCP tool configuration including server URL, transport type, and authentication details

namestring · min: 1 · max: 100Required

The name of the MCP tool.

descriptionany ofOptional

The description of the MCP tool.

stringOptional
or
nullOptional
transport_typestring · enumRequired

Transport protocol ('SSE' or 'HTTP').

Possible values:
server_urlstringRequired

Valid HTTP/HTTPS URL of the MCP server.

authenticationany ofOptional

Authentication configuration.

or
nullOptional
Responses
post
/admin/agents/tools/mcp

Get all MCP tools

get

Get all MCP tools

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search tools by name or description

Default: ""
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/tools/mcp/all

Upload a custom tool

post

Upload a custom tool to the server

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body
filestring · binaryRequired

The plugin file to upload

Responses
post
/admin/agents/tools/custom/upload

Update a custom tool

put

Update a custom tool

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired
Body
filestring · binaryRequired

The plugin file to upload

Responses
chevron-right
200

Successful Response

application/json
put
/admin/agents/tools/custom/{id}/upload

Get a custom tool

get

Get a custom tool

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/tools/custom/{id}

Delete a custom tool

delete

Delete a custom tool

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired
Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/agents/tools/custom/{id}

No content

Get MCP details

get

Get an MCP details including tools available from the server

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired

UUID of the MCP tool to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/tools/mcp/{id}

Update MCP tool

put

Updates an existing MCP tool configuration in AIP service and syncs metadata locally. Supports partial updates and validates new configuration before applying changes.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired

UUID of the MCP tool to update

Body

Updated MCP tool configuration (supports partial updates)

nameany ofOptional

The name of the MCP tool.

string · min: 1 · max: 100Optional
or
nullOptional
descriptionany ofOptional

The description of the MCP tool.

stringOptional
or
nullOptional
transport_typeany ofOptional

Transport protocol ('SSE' or 'HTTP').

string · enumOptional

Type of transport.

Possible values:
or
nullOptional
server_urlany ofOptional

Valid HTTP/HTTPS URL of the MCP server.

stringOptional
or
nullOptional
authenticationany ofOptional

Authentication configuration.

or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/agents/tools/mcp/{id}

Delete MCP tool

delete

Deletes an existing MCP tool configuration from AIP service and removes local metadata. The tool is first deleted from AIP service, and only if successful, the local metadata is cleaned up to maintain consistency.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired

UUID of the MCP tool to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/agents/tools/mcp/{id}

No content

Test MCP connection

post

Tests the connection to an MCP server and returns available tools. Validates server configuration, authentication, and retrieves tool definitions. This is a direct proxy to AIP service with no local storage.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

MCP server connection configuration to test including URL, transport type, and authentication

namestringRequired

The name of the MCP tool.

transport_typestring · enumRequired

Transport protocol ('sse' or 'http').

Possible values:
server_urlstringRequired

Valid HTTP/HTTPS URL of the MCP server.

authenticationany ofOptional

Authentication configuration.

or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/agents/tools/mcp/test-connection

Get MCP tools

get

Get MCP tools

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired

UUID of the MCP tool to get tools from

Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/tools/mcp/{id}/tools

Load remote agent card

get

Fetches a remote agent card from a given URL.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
urlstringRequired

The URL of the remote agent card.

Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/remote

Create remote agent

post

Create a new remote agent with configuration for external A2A agent integration.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Request model for creating a remote agent.

Attributes: name (str): The name/identifier of the remote agent. url (str): The base URL of the remote agent. display_name (str): The display name of the remote agent. description (str): Description of the remote agent. version (str): Version of the remote agent. auth_type (str): Chosen authentication type (e.g., apiKey, oauth2). client_id (str | None): OAuth2 client ID (required if auth_type is oauth2). client_secret (str | None): OAuth2 client secret (required if auth_type is oauth2). api_key (str | None): API key for apiKey authentication (required if auth_type is apiKey). agent_id (str): The ID of the base agent, only have value after agent is created. svg_icon (str): The SVG icon of the remote agent. ignore_pii (bool): Flag indicating whether to ignore PII. Defaults to False. chat_history_limit (int): Maximum number of chat history messages to retain for this agent. Defaults to 20.

Example: { "name": "a2a-remote-chatbot", "url": "https://a2aremote.com", "display_name": "A2A Remote Chatbot", "description": "Remote chatbot for A2A integration", "version": "1.0.0", "auth_type": "apiKey", "client_id": "oauth_client_123", "client_secret": "oauth_secret_456", "api_key": "api_key_789", "svg_icon": "...", "agent_id": "agent-123", "ignore_pii": false, "chat_history_limit": 20 }

namestringRequired

The name/identifier of the remote agent

urlstringRequired

The base URL of the remote agent

display_namestring · max: 100Required

The display name of the remote agent

descriptionstringRequired

Description of the remote agent

versionstringRequired

Version of the remote agent

auth_typeany ofOptional

Chosen authentication type (e.g., apiKey, oauth2)

stringOptional
or
nullOptional
client_idany ofOptional

OAuth2 client ID (required if auth_type is oauth2)

stringOptional
or
nullOptional
client_secretany ofOptional

OAuth2 client secret (required if auth_type is oauth2)

stringOptional
or
nullOptional
api_keyany ofOptional

API key for apiKey authentication (required if auth_type is apiKey)

stringOptional
or
nullOptional
svg_iconany ofOptional

The SVG icon of the remote agent

stringOptional
or
nullOptional
agent_idany ofOptional

The ID of the base agent, only have value after agent is created

stringOptional
or
nullOptional
ignore_piibooleanOptional

Flag indicating whether to ignore PII. Defaults to False.

Default: false
chat_history_limitintegerOptional

Maximum number of chat history messages to retain for this agent.

Default: 20
Responses
chevron-right
200

Successful Response

application/json
post
/admin/agents/remote

Get remote agent by ID

get

Retrieve a single remote agent by ID with its configuration details.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
agent_idstringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/remote/{agent_id}

Update remote agent

put

Update an existing remote agent with new configuration details.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
agent_idstringRequired
Body

Request model for updating a remote agent.

Attributes: name (str): The name/identifier of the remote agent. url (str): The base URL of the remote agent. display_name (str): The display name of the remote agent. description (str): Description of the remote agent. version (str): Version of the remote agent. auth_type (str | None): Chosen authentication type (e.g., apiKey, oauth2). client_id (str | None): OAuth2 client ID (required if auth_type is oauth2). client_secret (str | None): OAuth2 client secret (required if auth_type is oauth2). api_key (str | None): API key for apiKey authentication (required if auth_type is apiKey). svg_icon (str | None): The SVG icon of the remote agent. ignore_pii (bool | None): Flag indicating whether to ignore PII. chat_history_limit (int | None): Maximum number of chat history messages to retain for this agent.

nameany ofOptional

The name/identifier of the remote agent

stringOptional
or
nullOptional
urlany ofOptional

The base URL of the remote agent

stringOptional
or
nullOptional
display_nameany ofOptional

The display name of the remote agent

string · max: 100Optional
or
nullOptional
descriptionany ofOptional

Description of the remote agent

stringOptional
or
nullOptional
versionany ofOptional

Version of the remote agent

stringOptional
or
nullOptional
auth_typeany ofOptional

Chosen authentication type (e.g., apiKey, oauth2)

stringOptional
or
nullOptional
client_idany ofOptional

OAuth2 client ID (required if auth_type is oauth2)

stringOptional
or
nullOptional
client_secretany ofOptional

OAuth2 client secret (required if auth_type is oauth2)

stringOptional
or
nullOptional
api_keyany ofOptional

API key for apiKey authentication (required if auth_type is apiKey)

stringOptional
or
nullOptional
svg_iconany ofOptional

The SVG icon of the remote agent

stringOptional
or
nullOptional
ignore_piiany ofOptional

Flag indicating whether to ignore PII

booleanOptional
or
nullOptional
chat_history_limitany ofOptional

Maximum number of chat history messages to retain for this agent

integerOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/agents/remote/{agent_id}

Delete remote agent

delete

Delete a remote agent and its configuration from the database.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
agent_idstringRequired
Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/agents/remote/{agent_id}

No content

Get audit log for Hitl

get

Get audit log for Hitl

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Audit log for Hitl

application/json
get
/admin/agents/audit-log/hitl

Get audit log for Hitl by request ID

get

Get audit log for Hitl by request ID

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
request_idstringRequired
Responses
chevron-right
200

Audit log for Hitl by request ID

application/json
get
/admin/agents/audit-log/hitl/{request_id}

Retrieve list of agents with pagination

get

Fetch a list of agents from both AIP service and database with optional filters and pagination. Returns agent summaries including basic information.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search query for agent name or description

Default: ""
show_allbooleanOptional

If True, show all agents including hidden ones

Default: false
agent_typeany ofOptional

Filter by agent type (native/custom/langflow)

string · enumOptional

Enumeration of supported agent types.

Possible values:
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents

Create new agent

post

Create a new agent in both AIP service and database. Returns the created agent details including configuration and metadata. Supports tool_configs for configuring tool-specific parameters.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Model for creating an agent.

Attributes: name (str): The name of the agent. version (str | None): Semantic version of the agent. Defaults to '1.0.0'. display_name (str): The display name of the agent. description (str): A brief description of the agent. model (str | None): The LLM model to use for this agent. language_model_id (str | None): ID of the language model from supported-models API (preferred). tools (list[str] | None): List of tool IDs. sub_agent_ids (list[str] | None): List of sub-agent IDs. mcps (list[str] | None): List of MCP IDs. timeout (int): The timeout value for the agent. chat_history_limit (int): Maximum number of chat history messages to retain for this agent. Defaults to 20. instructions (str): Instructions for the agent. ignore_pii (bool): Flag indicating whether to ignore PII. Defaults to False. svg_icon (str): The SVG string for the agent icon. created_by (str | None): The user who created the agent. tool_configs (dict[str, dict[str, Any]] | None): Configuration for each tool by tool ID. enable_memory (bool): Flag indicating whether to enable memory for the agent. mcp_configs (dict[str, dict[str, Any]] | None): MCP-level overrides such as allowed tool lists. tool_output_sharing (bool): Flag indicating whether to enable tool output sharing for the agent. Defaults to False. planning (bool): Flag indicating whether to enable planning for the agent. Defaults to False.

namestringRequired

The name of the agent.

versionany ofOptional

Semantic version of the agent.

stringOptional
or
nullOptional
display_namestring · max: 100Required

The display name of the agent.

descriptionstringRequired

A brief description of the agent.

modelany ofRequired

The LLM model to use for this agent.

stringOptional
or
nullOptional
language_model_idany ofOptional

ID of the language model from supported-models API.

stringOptional
or
nullOptional
toolsany ofOptional

List of tool IDs.

string[]Optional
or
nullOptional
sub_agent_idsany ofOptional

List of sub-agent IDs.

string[]Optional
or
nullOptional
mcpsany ofOptional

List of MCP IDs.

string[]Optional
or
nullOptional
timeoutintegerOptional

The timeout value for the agent.

Default: 60
chat_history_limitintegerOptional

Maximum number of chat history messages to retain for this agent.

Default: 20
instructionsstringRequired

Instructions for the agent.

ignore_piibooleanOptional

Flag indicating whether to ignore PII.

Default: false
svg_iconstringRequired

The SVG string for the agent icon.

created_byany ofOptional

The user who created the agent.

stringOptional
or
nullOptional
tool_configsany ofOptional

Configuration for each tool by tool ID.

or
nullOptional
enable_memorybooleanOptional

Flag indicating whether to enable memory for the agent.

Default: false
mcp_configsany ofOptional

Configuration overrides for each MCP ID.

or
nullOptional
tool_output_sharingbooleanOptional

Flag indicating whether to enable tool output sharing for the agent.

Default: false
planningbooleanOptional

Flag indicating whether to enable planning for the agent.

Default: false
Responses
chevron-right
200

Successful Response

application/json
post
/admin/agents

Retrieve list of agents

get

Fetch a list of agents from both AIP service and database with optional filters. Returns agent summaries including basic information. Use cache=true to only fetch from database without calling AIP service.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
querystringOptional

Search query for agent name or description

Default: ""
show_allbooleanOptional

If True, show all agents including hidden ones

Default: false
agent_typeany ofOptional

Filter by agent type (native/custom/langflow). Custom includes A2A agents.

string · enumOptional

Enumeration of supported agent types.

Possible values:
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/all

Get supported language models

get

Get a list of supported language models from AIP service with model_id and model_name. This endpoint fetches the latest available models from the AIP service instead of using hardcoded values.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/supported-models

Retrieve single agent

get

Fetch a single agent by ID from both AIP service and database. Returns detailed agent information including configuration and metadata.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
agent_idstringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/agents/{agent_id}

Update existing agent

put

Update an existing agent in the database. Returns the updated agent details including configuration and metadata. Supports tool_configs for configuring tool-specific parameters.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
agent_idstringRequired
Body

Model for updating an agent.

Attributes: name (str | None): The name of the agent. version (str | None): Semantic version of the agent. Defaults to '1.0.0'. display_name (str | None): The display name of the agent. description (str | None): A brief description of the agent. model (str | None): The LLM model to use for this agent. language_model_id (str | None): ID of the language model from supported-models API (preferred). tools (list[str] | None): List of tool IDs. sub_agent_ids (list[str] | None): List of sub-agent IDs. mcps (list[str] | None): List of MCP IDs. timeout (int | None): The timeout value for the agent. chat_history_limit (int | None): Maximum number of chat history messages to retain for this agent. Defaults 20. instructions (str | None): Instructions for the agent. ignore_pii (bool | None): Flag indicating whether to ignore PII. Defaults to False. svg_icon (str | None): The SVG string for the agent icon. tool_configs (dict[str, dict[str, Any]] | None): Configuration for each tool by tool ID. enable_memory (bool | None): Flag indicating whether to enable memory for the agent. mcp_configs (dict[str, dict[str, Any]] | None): MCP-level overrides such as allowed tool lists. tool_output_sharing (bool): Flag indicating whether to enable tool output sharing for the agent. planning (bool): Flag indicating whether to enable planning for the agent. Defaults to False.

nameany ofOptional

The name of the agent.

stringOptional
or
nullOptional
versionany ofOptional

Semantic version of the agent.

stringOptional
or
nullOptional
display_nameany ofOptional

The display name of the agent.

string · max: 100Optional
or
nullOptional
descriptionany ofOptional

A brief description of the agent.

stringOptional
or
nullOptional
modelany ofOptional

The LLM model to use for this agent.

stringOptional
or
nullOptional
language_model_idany ofOptional

ID of the language model from supported-models API.

stringOptional
or
nullOptional
toolsany ofOptional

List of tool IDs.

string[]Optional
or
nullOptional
sub_agent_idsany ofOptional

List of sub-agent IDs.

string[]Optional
or
nullOptional
mcpsany ofOptional

List of MCP IDs.

string[]Optional
or
nullOptional
timeoutany ofOptional

The timeout value for the agent.

integerOptional
or
nullOptional
chat_history_limitany ofOptional

Maximum number of chat history messages to retain for this agent.

integerOptional
or
nullOptional
instructionsany ofOptional

Instructions for the agent.

stringOptional
or
nullOptional
ignore_piiany ofOptional

Flag indicating whether to ignore PII.

booleanOptional
or
nullOptional
svg_iconany ofOptional

The SVG string for the agent icon.

stringOptional
or
nullOptional
tool_configsany ofOptional

Configuration for each tool by tool ID.

or
nullOptional
enable_memoryany ofOptional

Flag indicating whether to enable memory for the agent.

booleanOptional
or
nullOptional
mcp_configsany ofOptional

Configuration overrides for each MCP ID.

or
nullOptional
tool_output_sharingbooleanOptional

Flag indicating whether to enable tool output sharing for the agent.

Default: false
planningbooleanOptional

Flag indicating whether to enable planning for the agent.

Default: false
Responses
chevron-right
200

Successful Response

application/json
put
/admin/agents/{agent_id}

Delete agent

delete

Delete an agent from both AIP service and local database. The agent is first deleted from the AIP service, and only if successful, it is then deleted from the local database.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
agent_idstringRequired
Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/agents/{agent_id}

No content

Get Chatbots Page

get

Get a paginated list of chatbots with optional search filtering by name.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search query for chatbot names

pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/chatbots

Create Chatbot

post

Create a new chatbot with the provided configuration data including catalogs and user assignments.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body
user_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
preset_idstring · min: 36 · max: 36Required
chatbot_idstring · min: 1 · max: 100Required
chatbot_nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
descriptionstringOptionalDefault: ""
knowledge_base_idstring · min: 36 · max: 36Required
prompt_builder_catalog_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
lmrp_catalog_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
organization_idany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
recommended_questionsany ofOptional
stringOptional
or
nullOptional
supported_agent_idsstring[]OptionalDefault: []
prompt_builder_catalogsany ofOptional
stringOptional
or
nullOptional
lmrp_catalogsany ofOptional
stringOptional
or
nullOptional
prompt_builder_catalog_levelany ofOptional
string · enumOptional

Level type enum for catalogs.

Possible values:
or
nullOptional
lmrp_catalog_levelany ofOptional
string · enumOptional

Level type enum for catalogs.

Possible values:
or
nullOptional
connector_idsany ofOptional
string[]Optional
or
nullOptional
is_question_librarybooleanOptionalDefault: false
question_library_sourceany ofOptional
string · enumOptional

Enum for question library source.

Possible values:
or
nullOptional
display_typeany ofOptional
string · enumOptional

Enum for display type.

Possible values:
or
nullOptional
click_behaviourany ofOptional
string · enumOptional

Enum for click behaviour.

Possible values:
or
nullOptional
max_question_showany ofOptional
integerOptional
or
nullOptional
light_logoany ofOptional
string · binaryOptional
or
nullOptional
dark_logoany ofOptional
string · binaryOptional
or
nullOptional
use_tenant_logoany ofOptional
booleanOptional
or
nullOptional
show_app_logoany ofOptional
booleanOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/chatbots

Get Chatbots

get

Get a complete list of all chatbots in the system without pagination.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/chatbots/all

Get Chatbots With User Count

get

Get a paginated list of all chatbots along with their user counts.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search query for chatbot names

pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/chatbots/users

Get Chatbot

get

Get details for a specific chatbot by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/chatbots/{chatbot_id}

Delete Chatbot

delete

Delete a chatbot by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to delete

Responses
delete
/admin/chatbots/{chatbot_id}

No content

Update Chatbot

put

Update an existing chatbot with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_id_pathstringRequired

The ID of the chatbot to update

Body
chatbot_idany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
chatbot_nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
descriptionany ofOptional
stringOptional
or
nullOptional
preset_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
knowledge_base_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
prompt_builder_catalog_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
lmrp_catalog_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
organization_idany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
recommended_questionsany ofOptional
stringOptional
or
nullOptional
supported_agent_idsany ofOptionalDefault: []
string[]Optional
or
nullOptional
prompt_builder_catalogsany ofOptional
stringOptional
or
nullOptional
lmrp_catalogsany ofOptional
stringOptional
or
nullOptional
prompt_builder_catalog_levelany ofOptional
string · enumOptional

Level type enum for catalogs.

Possible values:
or
nullOptional
lmrp_catalog_levelany ofOptional
string · enumOptional

Level type enum for catalogs.

Possible values:
or
nullOptional
connector_idsany ofOptional
string[]Optional
or
nullOptional
is_question_librarybooleanOptionalDefault: false
question_library_sourceany ofOptional
string · enumOptional

Enum for question library source.

Possible values:
or
nullOptional
display_typeany ofOptional
string · enumOptional

Enum for display type.

Possible values:
or
nullOptional
click_behaviourany ofOptional
string · enumOptional

Enum for click behaviour.

Possible values:
or
nullOptional
max_question_showany ofOptional
integerOptional
or
nullOptional
light_logoany ofOptional
string · binaryOptional
or
nullOptional
dark_logoany ofOptional
string · binaryOptional
or
nullOptional
use_tenant_logoany ofOptional
booleanOptional
or
nullOptional
show_app_logoany ofOptional
booleanOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/chatbots/{chatbot_id_path}

Add Users To Chatbot

post

Assign additional users to a chatbot while preserving existing user assignments.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to add users to

Body

Request model for adding users to a chatbot.

This model represents the data required to assign users and domains to a specific chatbot for access control and management.

Attributes: user_ids (list[str]): List of user IDs that should be directly assigned to the chatbot. domain_ids (list[str]): List of domain IDs that should be assigned to the chatbot.

user_idsstring[]Optional

List of user IDs that should be directly assigned to the chatbot.

Default: []
domain_idsstring[]Optional

List of domain IDs that should be assigned to the chatbot.

Default: []
Responses
chevron-right
200

Successful Response

application/json
post
/admin/chatbots/{chatbot_id}/assign

Get Users By Chatbot Id

get

Get a paginated list of users directly assigned to a specific chatbot.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to retrieve users for

Query parameters
searchany ofOptional

Search query for user names

stringOptional
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/chatbots/{chatbot_id}/users

Get Users Not Assigned To Chatbot

get

Get all users that are not currently assigned to the specified chatbot.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to retrieve users for

Query parameters
searchany ofOptional

Search query for user names

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/chatbots/{chatbot_id}/users/not-assigned

Delete User By Chatbot Id

delete

Remove a specific user's access assignment from a chatbot.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to delete users for

user_idstringRequired

The ID of the user to delete

Responses
delete
/admin/chatbots/{chatbot_id}/users/{user_id}

No content

Get Domains By Chatbot Id

get

Get a paginated list of domains associated with a specific chatbot.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to retrieve domains for

Query parameters
searchany ofOptional

Search query for domain names

stringOptional
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/chatbots/{chatbot_id}/domains

Delete Domain By Chatbot Id

delete

Remove a specific domain's access assignment from a chatbot.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to delete domains for

domain_idstringRequired

The ID of the domain to delete

Responses
delete
/admin/chatbots/{chatbot_id}/domains/{domain_id}

No content

Get Domains Not Assigned To Chatbot

get

Get all domains that are not currently assigned to the specified chatbot.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The ID of the chatbot to retrieve domains for

Query parameters
searchany ofOptional

Search query for domain names

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/chatbots/{chatbot_id}/domains/not-assigned

Get All Organizations Slugs

get

Get all organizations slugs

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
Responsestring[]
get
/admin/company/slugs

Get Organization By Tenant Id Header

get

Get organization by tenant id header

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/company

Create Organization

post

Create organization

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body
namestring · min: 1 · max: 255Required

Organization name

slugany ofOptional

Organization slug (URL-friendly identifier)

string · min: 1 · max: 100OptionalPattern: ^[a-z0-9\-]+$
or
nullOptional
support_contact_emailany ofOptional

Support contact email

stringOptional
or
nullOptional
primary_colorany ofOptional

Primary color in hex code (e.g., #000000) or an empty string

stringOptionalPattern: ^(#([0-9a-fA-F]{6}))?$
or
nullOptional
secondary_colorany ofOptional

Secondary color in hex code (e.g., #000000) or an empty string

stringOptionalPattern: ^(#([0-9a-fA-F]{6}))?$
or
nullOptional
accent_colorany ofOptional

Accent color in hex code (e.g., #000000) or an empty string

stringOptionalPattern: ^(#([0-9a-fA-F]{6}))?$
or
nullOptional
light_logoany ofOptional

Light logo file

string · binaryOptional
or
nullOptional
dark_logoany ofOptional

Dark logo file

string · binaryOptional
or
nullOptional
light_iconany ofOptional

Light icon file

string · binaryOptional
or
nullOptional
dark_iconany ofOptional

Dark icon file

string · binaryOptional
or
nullOptional
light_logo_urlany ofOptional

Light logo URL

stringOptional
or
nullOptional
dark_logo_urlany ofOptional

Dark logo URL

stringOptional
or
nullOptional
light_icon_urlany ofOptional

Light icon URL

stringOptional
or
nullOptional
dark_icon_urlany ofOptional

Dark icon URL

stringOptional
or
nullOptional
user_domainsstring[] · max: 100Optional

Email domains, e.g. ['example.com', 'gdplabs.id']

feedback_urlany ofOptional

Feedback URL

stringOptional
or
nullOptional
user_guide_urlany ofOptional

User guide URL

stringOptional
or
nullOptional
admin_guide_urlany ofOptional

Admin guide URL

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/company

Update Organization

put

Update organization name, main color, secondary color, accent color, logo, and icon.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body
namestring · min: 1 · max: 255Required

Organization name

slugany ofOptional

Organization slug (URL-friendly identifier)

string · min: 1 · max: 100Optional
or
nullOptional
support_contact_emailany ofOptional

Support contact email

stringOptional
or
nullOptional
primary_colorstringOptional

Primary color in hex code (e.g., #000000) or an empty string

Default: ""Pattern: ^(#([0-9a-fA-F]{6}))?$
secondary_colorstringOptional

Secondary color in hex code (e.g., #000000) or an empty string

Default: ""Pattern: ^(#([0-9a-fA-F]{6}))?$
accent_colorstringOptional

Accent color in hex code (e.g., #000000) or an empty string

Default: ""Pattern: ^(#([0-9a-fA-F]{6}))?$
light_logoany ofOptional

Light logo file

string · binaryOptional
or
nullOptional
dark_logoany ofOptional

Dark logo file

string · binaryOptional
or
nullOptional
light_iconany ofOptional

Light icon file

string · binaryOptional
or
nullOptional
dark_iconany ofOptional

Dark icon file

string · binaryOptional
or
nullOptional
user_domainsstring[]Required

Email domains, e.g. ['example.com', 'gdplabs.id']

feedback_urlany ofOptional

Feedback URL

stringOptional
or
nullOptional
user_guide_urlany ofOptional

User guide URL

stringOptional
or
nullOptional
admin_guide_urlany ofOptional

Admin guide URL

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/company

Enqueue Decrypt Job

post

Enqueue background task to decrypt all messages for the current tenant.

Body

Encryption job request schema.

tenant_idstringRequired
batch_sizeintegerOptionalDefault: 1000
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/admin/company/encryption/jobs/decrypt

No content

Enqueue Encrypt Job

post

Enqueue background task to encrypt all messages for the current tenant.

Body

Encryption job request schema.

tenant_idstringRequired
batch_sizeintegerOptionalDefault: 1000
Responses
chevron-right
200

Successful Response

application/json
Responseany
post
/admin/company/encryption/jobs/encrypt

No content

Get Crypto Job Status

get

Get Celery task status and progress for encrypt/decrypt jobs.

Path parameters
task_idstringRequired
Responses
chevron-right
200

Successful Response

application/json
Responseany
get
/admin/company/encryption/jobs/{task_id}

No content

Get Organization By Slug

get

Get organization by slug

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
slugstringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/company/{slug}

Get Organization By Name

get

Get organization by name

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
namestringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/company/name/{name}

Delete Organization

delete

Delete organization

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired
Responses
delete
/admin/company/{id}

No content

Get Components

get

Get a complete list of all components in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/components

Create Component

post

Create a new component with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create component request schema.

namestring · min: 3 · max: 100Required
display_namestring · min: 1 · max: 100Required
descriptionany ofOptional
stringOptional
or
nullOptional
Responses
post
/admin/components

Get Component

get

Get details for a specific component by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
component_idstringRequired

The ID of the component

Responses
chevron-right
200

Successful Response

application/json
get
/admin/components/{component_id}

Update Component

put

Update an existing component with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
component_idstringRequired

The ID of the component to update

Body

Update component request schema.

nameany ofOptional
string · min: 3 · max: 100Optional
or
nullOptional
display_nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
descriptionany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/components/{component_id}

Delete Component

delete

Delete a specific component by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
component_idstringRequired

The ID of the component to delete

Responses
delete
/admin/components/{component_id}

No content

Get Config Fields

get

Get configuration fields associated with specified component IDs.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
component_idsstring[]Required

List of component IDs

Responses
chevron-right
200

Successful Response

application/json
get
/admin/config-fields

Create Config Field

post

Create a new configuration field with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create config field request schema.

component_idstring · min: 36 · max: 36Required
namestring · min: 1 · max: 100Required
typestring · min: 1 · max: 20Required
constraintsany ofOptional
stringOptional
or
nullOptional
default_valueany ofOptional
stringOptional
or
nullOptional
ui_typestring · min: 1 · max: 20Required
dropdown_sourceany ofOptional
stringOptional
or
nullOptional
dropdown_keyany ofOptional
string · max: 100Optional
or
nullOptional
dropdown_valueany ofOptional
string · max: 100Optional
or
nullOptional
dropdown_filterany ofOptional
stringOptional
or
nullOptional
levelstring · min: 1 · max: 20Required
category_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
Responses
post
/admin/config-fields

Get Dropdown Config Fields

get

Get dropdown-type configuration fields from the specified source for UI rendering.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
sourcestringRequired

The source of the dropdown config fields

Responses
chevron-right
200

Successful Response

application/json
get
/admin/config-fields/dropdown

Get Config Field

get

Get details for a specific configuration field by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
config_field_idstringRequired

The ID of the config field

Responses
chevron-right
200

Successful Response

application/json
get
/admin/config-fields/{config_field_id}

Update Config Field

put

Update an existing configuration field with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
config_field_idstringRequired

The ID of the config field to update

Body

Update config field request schema.

nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
typeany ofOptional
string · min: 1 · max: 20Optional
or
nullOptional
constraintsany ofOptional
stringOptional
or
nullOptional
default_valueany ofOptional
stringOptional
or
nullOptional
ui_typeany ofOptional
string · min: 1 · max: 20Optional
or
nullOptional
dropdown_sourceany ofOptional
stringOptional
or
nullOptional
dropdown_keyany ofOptional
string · max: 100Optional
or
nullOptional
dropdown_valueany ofOptional
string · max: 100Optional
or
nullOptional
dropdown_filterany ofOptional
stringOptional
or
nullOptional
levelany ofOptional
string · min: 1 · max: 20Optional
or
nullOptional
category_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/config-fields/{config_field_id}

Delete Config Field

delete

Delete a specific configuration field by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
config_field_idstringRequired

The ID of the config field to delete

Responses
delete
/admin/config-fields/{config_field_id}

No content

Get Connectors

get

Get list of connectors

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/connectors

Create Connector

post

Create new connector

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Connector create request schema.

Attributes: name (str): Connector name. display_name (str): Connector display name. description (str | None, optional): Connector description. Defaults to None. icon (str | None, optional): Connector icon. Defaults to None. is_active (bool): Whether the connector is active. knowledge_source (bool): Whether the connector is a knowledge source.

namestringRequired

Connector name.

display_namestringRequired

Connector display name.

descriptionany ofOptional

Connector description.

stringOptional
or
nullOptional
iconany ofOptional

Connector icon.

stringOptional
or
nullOptional
is_activebooleanOptional

Whether the connector is active.

Default: false
knowledge_sourcebooleanOptional

Whether the connector will be shown in Option dropdown and user connector list

Default: false
Responses
chevron-right
200

Successful Response

application/json
post
/admin/connectors

Get Connectors Management

get

Get list of connectors for connector management page

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/connectors/management

Get Available Connectors

get

Get available connectors from BOSA

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/connectors/available-connectors

Get Connectors Dropdown Chatbot Connector

get

Get list of connectors for dropdown chatbot connector form

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/connectors/dropdown/chatbot-connector

Get Connector By Name

get

Get connector by name

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
namestringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/connectors/{name}

Delete Connector

delete

Delete connector

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
namestringRequired
Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/connectors/{name}

No content

Update Connector Is Active

patch

Update connector is_active

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
namestringRequired
Body

Connector update request schema.

Attributes: display_name (str | None, optional): Connector display name. Defaults to None. description (str | None, optional): Connector description. Defaults to None. icon (str | None, optional): Connector icon. Defaults to None. is_active (bool | None, optional): Whether the connector is active. Defaults to None. knowledge_source (bool | None, optional): Whether the connector will be shown in Option dropdown and user connector list. Defaults to None.

display_nameany ofOptional

Connector display name.

stringOptional
or
nullOptional
descriptionany ofOptional

Connector description.

stringOptional
or
nullOptional
iconany ofOptional

Connector icon.

stringOptional
or
nullOptional
is_activeany ofOptional

Whether the connector is active.

booleanOptional
or
nullOptional
knowledge_sourceany ofOptional

Whether the connector will be shown in Option dropdown and user connector list

booleanOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
patch
/admin/connectors/{name}

Connect Admin Connector

post

Connect admin to connector

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
namestringRequired
Body
callback_urlstringRequired
Responses
chevron-right
200

Successful Response

application/json
post
/admin/connectors/{name}/connect

Get Admin Connector Integrations

get

Get admin integrations for connector

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
namestringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/connectors/{name}/integrations

Remove Admin Connector Integration

delete

Remove admin integration from connector

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
namestringRequired
user_identifierstringRequired
Responses
delete
/admin/connectors/{name}/integrations/{user_identifier}

No content

Get Envs

get

Get a paginated list of environment variables with optional search filtering by name.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchany ofOptional

Filter keys by name (partial match)

stringOptional
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/envs

Create Env

post

Create a new environment variable with encrypted storage.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

The environment variable creation request

namestring · min: 1 · max: 255Required

Environment variable name

Pattern: ^[a-zA-Z0-9_\-]+$
valuestring · min: 1Required

Environment variable value

typestring · enumOptional

Environment variable type

Default: KEYPossible values:
organization_idany ofOptional

The organization ID

stringOptional
or
nullOptional
Responses
post
/admin/envs

Get All Envs

get

Get all environment variables.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/envs/all

Get All Default Config Envs

get

Get all default config environment variables.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/envs/default-config

Get Env By Id

get

Get environment variable details including the decrypted value.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired

The ID of the environment variable

Responses
chevron-right
200

Successful Response

application/json
get
/admin/envs/{id}

Update Env

put

Update an existing environment variable.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired

The ID of the environment variable to update

Body

The environment variable update request

namestring · min: 1 · max: 255Required

Environment variable name

Pattern: ^[a-zA-Z0-9_\-]+$
valueany ofOptional

Environment variable value

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/envs/{id}

Delete Env

delete

Delete an environment variable.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
idstringRequired

The ID of the environment variable to delete

Responses
delete
/admin/envs/{id}

No content

Batch Create Organization Envs

post

Create multiple environment variables in batch for an organization.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Batch create environment variables request

Responses
post
/admin/envs/batch/organization

Get Knowledge Bases Page

get

Get a paginated list of knowledge bases with optional search filtering by name.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search query for knowledge base names

pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/knowledge-bases

Create Knowledge Base

post

Create a new knowledge base with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create knowledge base request schema.

Attributes: knowledge_base_id (str): Knowledge base ID (1-100 characters). knowledge_base_name (str): Knowledge base name (0-100 characters). knowledge_base_description (str | None, optional): Knowledge base description. Defaults to None. index_name (str): Index name (1-100 characters). dpo_preset_id (str): DPO preset ID (36 characters). ttl (int, optional): Time to live. Defaults to 120. max_faq (int, optional): Maximum FAQ. Defaults to 50. is_processing_answer (bool, optional): Whether processing answer is enabled. Defaults to False. user (CurrentUser | None, optional): Current user information. Defaults to None.

knowledge_base_idstring · min: 1 · max: 100Required
knowledge_base_namestring · max: 100Required
knowledge_base_descriptionany ofOptional
stringOptional
or
nullOptional
index_namestring · min: 1 · max: 100Required
dpo_preset_idstring · min: 36 · max: 36Required
ttlintegerOptionalDefault: 120
max_faqintegerOptionalDefault: 50
is_processing_answerbooleanOptionalDefault: false
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/knowledge-bases

Get Knowledge Bases

get

Get a complete list of all knowledge bases in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/knowledge-bases/all

Get Knowledge Base

get

Get details for a specific knowledge base by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
knowledge_base_idstringRequired

The ID of the knowledge base to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/knowledge-bases/{knowledge_base_id}

Update Knowledge Base

put

Update an existing knowledge base with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
knowledge_base_idstringRequired

The ID of the knowledge base to update

Body

Update knowledge base request schema.

Attributes: knowledge_base_id (str | None, optional): Knowledge base ID (1-100 characters). Defaults to None. knowledge_base_name (str | None, optional): Knowledge base name (1-100 characters). Defaults to None. knowledge_base_description (str | None, optional): Knowledge base description. Defaults to None. index_name (str | None, optional): Index name (1-100 characters). Defaults to None. dpo_preset_id (str | None, optional): DPO preset ID (36 characters). Defaults to None. ttl (int | None, optional): Time to live. Defaults to None. max_faq (int | None, optional): Maximum FAQ. Defaults to None. is_processing_answer (bool | None, optional): Whether processing answer is enabled. Defaults to None. user (CurrentUser | None, optional): Current user information. Defaults to None.

knowledge_base_idany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
knowledge_base_nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
knowledge_base_descriptionany ofOptional
stringOptional
or
nullOptional
index_nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
dpo_preset_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
ttlany ofOptional
integerOptional
or
nullOptional
max_faqany ofOptional
integerOptional
or
nullOptional
is_processing_answerany ofOptional
booleanOptional
or
nullOptional
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/knowledge-bases/{knowledge_base_id}

Delete Knowledge Base

delete

Delete a specific knowledge base by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
knowledge_base_idstringRequired

The ID of the knowledge base to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/knowledge-bases/{knowledge_base_id}

No content

Register With Smart Search

post

Register an existing knowledge base with smart search external service.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
knowledge_base_idstringRequired

The ID of the knowledge base to register with smart search

Responses
chevron-right
200

Successful Response

application/json
post
/admin/knowledge-bases/{knowledge_base_id}/register-smart-search
delete

Unregister an existing knowledge base from smart search external service.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
knowledge_base_idstringRequired

The ID of the knowledge base to unregister from smart search

Responses
chevron-right
200

Successful Response

application/json
delete
/admin/knowledge-bases/{knowledge_base_id}/unregister-smart-search

Get Distinct Documents

get

Get all distinct documents (file_id and file_name)where conversation_id is null from the vector database.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
index_namestringRequired

The index name to query documents from

Responses
chevron-right
200

Successful Response

application/json
get
/admin/knowledge-bases/documents/{index_name}

Get All Lmrp Catalogs

get

Get a complete list of all LMRP catalogs in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/lmrp-catalogs/all

Get Lmrp Catalog By Pipeline Id

get

Get a specific LMRP catalog associated with the provided pipeline ID.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
pipeline_idstringRequired

The ID of the pipeline to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/lmrp-catalogs

Create Lmrp Catalog

post

Create a new LMRP catalog with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create LMRP catalog request schema.

Attributes: name (str): The name of the LMRP catalog. description (str | None): The description of the LMRP catalog. is_override (bool): Whether the LMRP catalog is an override of CHATBOT catalog. level (CatalogLevelType): The level of the LMRP catalog. level_entity_id (str | None): The ID of the entity that the LMRP catalog belongs to.

namestring · min: 1 · max: 100Required
descriptionany ofOptional
stringOptional
or
nullOptional
is_overridebooleanOptionalDefault: false
levelstring · enum · min: 1 · max: 50Required

Level type enum for catalogs.

Possible values:
level_entity_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
Responses
post
/admin/lmrp-catalogs

Get Lmrp Catalog By Id

get

Get details for a specific LMRP catalog by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
lmrp_catalog_idstringRequired

The ID of the LMRP catalog to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/lmrp-catalogs/{lmrp_catalog_id}

Update Lmrp Catalog

put

Update an existing LMRP catalog with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
lmrp_catalog_idstringRequired

The ID of the LMRP catalog to update

Body

Update LMRP catalog request schema.

Attributes: name (str | None): The name of the LMRP catalog. description (str | None): The description of the LMRP catalog. is_override (bool | None): Whether the LMRP catalog is an override of CHATBOT catalog. level (CatalogLevelType | None): The level of the LMRP catalog. level_entity_id (str | None): The ID of the entity that the LMRP catalog belongs to.

nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
descriptionany ofOptional
stringOptional
or
nullOptional
is_overrideany ofOptional
booleanOptional
or
nullOptional
levelany ofOptional
string · enum · min: 1 · max: 50Optional

Level type enum for catalogs.

Possible values:
or
nullOptional
level_entity_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/lmrp-catalogs/{lmrp_catalog_id}

Delete Lmrp Catalog

delete

Delete a specific LMRP catalog by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
lmrp_catalog_idstringRequired

The ID of the LMRP catalog to delete

Responses
delete
/admin/lmrp-catalogs/{lmrp_catalog_id}

No content

Get Lmrp Catalog Entry

get

Get details for a specific LMRP catalog entry by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
lmrp_catalog_entry_idstringRequired

The ID of the LMRP catalog entry to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/lmrp-catalog-entries/{lmrp_catalog_entry_id}

Update Lmrp Catalog Entry

put

Update an existing LMRP catalog entry with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
lmrp_catalog_entry_idstringRequired

The ID of the LMRP catalog entry to update

Body

Update LMRP catalog entry request schema.

Attributes: name (str | None): The name of the LMRP catalog entry. scope (str | None): The scope of the LMRP catalog entry. prompt_builder_type (str | None): The type of the prompt builder. prompt_builder_kwargs (str | None): The kwargs of the prompt builder. prompt_builder_system_template (str | None): The system template of the prompt builder. prompt_builder_user_template (str | None): The user template of the prompt builder. model_id (str | None): The ID of the model. output_parser_type (str | None): The type of the output parser. output_parser_kwargs (str | None): The kwargs of the output parser. user (CurrentUser | None): The current user for audit tracking. Defaults to None.

nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
scopeany ofOptional
stringOptional
or
nullOptional
prompt_builder_typeany ofOptional
stringOptional
or
nullOptional
prompt_builder_kwargsany ofOptional
stringOptional
or
nullOptional
prompt_builder_system_templateany ofOptional
stringOptional
or
nullOptional
prompt_builder_user_templateany ofOptional
stringOptional
or
nullOptional
model_idany ofOptional
stringOptional
or
nullOptional
output_parser_typeany ofOptional
stringOptional
or
nullOptional
output_parser_kwargsany ofOptional
stringOptional
or
nullOptional
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/lmrp-catalog-entries/{lmrp_catalog_entry_id}

Delete Lmrp Catalog Entry

delete

Delete a specific LMRP catalog entry by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
lmrp_catalog_entry_idstringRequired

The ID of the LMRP catalog entry to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/lmrp-catalog-entries/{lmrp_catalog_entry_id}

No content

Create Lmrp Catalog Entry

post

Create a new LMRP catalog entry with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create LMRP catalog entry request schema.

Attributes: name (str): The name of the LMRP catalog entry. lmrp_catalog_id (str | None): The ID of the LMRP catalog. scope (str | None): The scope of the LMRP catalog entry. prompt_builder_type (str): The type of the prompt builder. prompt_builder_kwargs (str | None): The kwargs of the prompt builder. prompt_builder_system_template (str | None): The system template of the prompt builder. prompt_builder_user_template (str | None): The user template of the prompt builder. model_id (str | None): The ID of the model. output_parser_type (str | None): The type of the output parser. output_parser_kwargs (str | None): The kwargs of the output parser.

namestring · min: 1 · max: 100Required
lmrp_catalog_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
scopeany ofOptional
stringOptional
or
nullOptional
prompt_builder_typestring · min: 1 · max: 100Required
prompt_builder_kwargsany ofOptional
stringOptional
or
nullOptional
prompt_builder_system_templateany ofOptional
stringOptional
or
nullOptional
prompt_builder_user_templateany ofOptional
stringOptional
or
nullOptional
model_idany ofOptional
stringOptional
or
nullOptional
output_parser_typeany ofOptional
stringOptional
or
nullOptional
output_parser_kwargsany ofOptional
stringOptional
or
nullOptional
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/lmrp-catalog-entries

Get Midnight Faqs Page By Knowledge Base

get

Get a paginated list of midnight FAQs with optional filtering by search, status, and date ranges.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
knowledge_base_idstringRequired

Knowledge base ID to filter FAQs

searchany ofOptional

Search query for FAQ questions or answers

stringOptional
or
nullOptional
statusany ofOptional

Filter by FAQ status

string · enumOptional

Enumeration of possible FAQ statuses.

Possible values:
or
nullOptional
date_fromany ofOptional

Filter FAQs created or updated from this date (ISO format)

string · date-timeOptional
or
nullOptional
date_toany ofOptional

Filter FAQs created or updated up to this date (ISO format)

string · date-timeOptional
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/midnight-faqs

Create Midnight Faq

post

Create a new midnight FAQ with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Midnight FAQ configuration data

questionstring · min: 1Required
answerstringOptionalDefault: ""
model_idany ofOptional
stringOptional
or
nullOptional
categorystringOptionalDefault: ""
statusany ofOptional
string · enumOptional

Enumeration of possible FAQ statuses.

Possible values:
or
nullOptional
knowledge_base_idstring · min: 36 · max: 36Required
Responses
post
/admin/midnight-faqs

Get Midnight Faq By Id

get

Get a specific midnight FAQ by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
faq_idstringRequired

The ID of the midnight FAQ to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/midnight-faqs/{faq_id}

Update Midnight Faq

put

Update an existing midnight FAQ with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
faq_idstringRequired

The ID of the midnight FAQ to update

Body

Updated midnight FAQ configuration data

questionstring · min: 1Required
answerstring · min: 1Required
model_idany ofOptional
stringOptional
or
nullOptional
categoryany ofOptional
stringOptional
or
nullOptional
statusstring · enumRequired

Enumeration of possible FAQ statuses.

Possible values:
knowledge_base_idstring · min: 36 · max: 36Required
Responses
chevron-right
200

Successful Response

application/json
put
/admin/midnight-faqs/{faq_id}

Delete Midnight Faq

delete

Delete a specific midnight FAQ by its unique identifier (soft delete).

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
faq_idstringRequired

The ID of the midnight FAQ to delete

Responses
delete
/admin/midnight-faqs/{faq_id}

No content

Get Midnight Faqs By Knowledge Base Id

get

Get midnight FAQs associated with a specific knowledge base with optional filtering by status and date ranges.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
knowledge_base_idstringRequired

The ID of the knowledge base

Query parameters
statusany ofOptional

Filter by FAQ status

string · enumOptional

Enumeration of possible FAQ statuses.

Possible values:
or
nullOptional
date_fromany ofOptional

Filter FAQs created or updated from this date (ISO format)

string · date-timeOptional
or
nullOptional
date_toany ofOptional

Filter FAQs created or updated up to this date (ISO format)

string · date-timeOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/midnight-faqs/by-knowledge-base/{knowledge_base_id}

Get Midnight Faqs By Model Id

get

Get midnight FAQs associated with a specific model.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
model_idstringRequired

The ID of the model

Responses
chevron-right
200

Successful Response

application/json
get
/admin/midnight-faqs/by-model/{model_id}

Get Midnight Faqs By Category

get

Get midnight FAQs filtered by category.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
categorystringRequired

The category name

Responses
chevron-right
200

Successful Response

application/json
get
/admin/midnight-faqs/by-category/{category}

Get Midnight Faqs By Status

get

Get midnight FAQs filtered by status.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
statusstring · enumRequired

The status value

Possible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/midnight-faqs/by-status/{status}

Bulk Update Status

patch

Bulk update status of multiple midnight FAQs.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Bulk update status request data

faq_idsstring[] · min: 1Required
statusstring · enumRequired

Enumeration of possible FAQ statuses.

Possible values:
Responses
chevron-right
200

Successful Response

application/json
patch
/admin/midnight-faqs/bulk-update-status

Bulk Delete

delete

Bulk delete multiple midnight FAQs (soft delete).

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Bulk delete request data

faq_idsstring[] · min: 1Required
Responses
chevron-right
200

Successful Response

application/json
delete
/admin/midnight-faqs/bulk-delete

Generate Answer

post

Generate an answer for a given question using optional source documents.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Generate answer request data

questionstring · min: 1Required

The question to generate an answer for

source_file_idsany ofOptional

Optional source files id to use for answer generation

string[]Optional
or
nullOptional
knowledge_base_idstring · min: 1Required

The knowledge base ID to use for answer generation

Responses
chevron-right
200

Successful Response

application/json
post
/admin/midnight-faqs/generate-answer

Get Models

get

Get a complete list of all available models in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchany ofOptional

Search query for model names

stringOptional
or
nullOptional
model_typeany ofOptional

Filter by model type (LLM or LMRP)

string · enumOptional

Model type enum for models.

Possible values:
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/models

Create Model

post

Create a new model with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Model creation request schema.

Attributes: name (str): Unique identifier for the model. display_name (str | None, optional): Display name for the model. Defaults to None. description (str | None, optional): Description of the model. Defaults to None. icon (str | None, optional): Icon for the model. Defaults to None. supported_attachments (dict[str, list[str]], optional): Supported attachments configuration. Defaults to {}. is_active (bool, optional): Is the model active. Defaults to True. provider_id (str): Provider ID for the model. model_kwargs (str | None, optional): Model kwargs. Defaults to None. model_env_kwargs (str | None, optional): Model env kwargs. Defaults to None. prompt_template_group_id (str | None, optional): Prompt template group ID for the model. Defaults to None. type (ModelType, optional): Model type (LLM or LMRP). Defaults to ModelType.LLM. user (CurrentUser | None, optional): Current user information. Defaults to None.

namestringRequired

Unique identifier for the model

display_nameany ofOptional

Display name for the model

stringOptional
or
nullOptional
descriptionany ofOptional

Description of the model

stringOptional
or
nullOptional
iconany ofOptional

Icon for the model

stringOptional
or
nullOptional
is_activebooleanOptional

Is the model active

Default: true
provider_idstringRequired

Provider ID for the model

model_kwargsany ofOptional

Model kwargs

stringOptional
or
nullOptional
model_env_kwargsany ofOptional

Model env kwargs

stringOptional
or
nullOptional
prompt_template_group_idany ofOptional

Prompt template group ID for the model

stringOptional
or
nullOptional
typestring · enumOptional

Model type (LLM or LMRP)

Default: LLMPossible values:
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/models

Get Model

get

Get details for a specific model by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
model_idstringRequired

The ID of the model to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/models/{model_id}

Update Model

put

Update an existing model with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
model_idstringRequired

The ID of the model to update

Body

Model update request schema.

Attributes: name (str | None, optional): Unique identifier for the model. Defaults to None. display_name (str | None, optional): Display name for the model. Defaults to None. description (str | None, optional): Description of the model. Defaults to None. icon (str | None, optional): Icon for the model. Defaults to None. supported_attachments (dict[str, list[str]], optional): Supported attachments configuration. Defaults to {}. is_active (bool | None, optional): Is the model active. Defaults to None. provider_id (str | None, optional): Provider ID for the model. Defaults to None. model_kwargs (str | None, optional): Model kwargs. Defaults to None. model_env_kwargs (str | None, optional): Model env kwargs. Defaults to None. prompt_template_group_id (str | None, optional): Prompt template group ID for the model. Defaults to None. type (ModelType | None, optional): Model type (LLM or LMRP). Defaults to None. user (CurrentUser | None, optional): Current user information. Defaults to None.

nameany ofOptional

Unique identifier for the model

stringOptional
or
nullOptional
display_nameany ofOptional

Display name for the model

stringOptional
or
nullOptional
descriptionany ofOptional

Description of the model

stringOptional
or
nullOptional
iconany ofOptional

Icon for the model

stringOptional
or
nullOptional
is_activeany ofOptional

Is the model active

booleanOptional
or
nullOptional
provider_idany ofOptional

Provider ID for the model

stringOptional
or
nullOptional
model_kwargsany ofOptional

Model kwargs

stringOptional
or
nullOptional
model_env_kwargsany ofOptional

Model env kwargs

stringOptional
or
nullOptional
prompt_template_group_idany ofOptional

Prompt template group ID for the model

stringOptional
or
nullOptional
typeany ofOptional

Model type (LLM or LMRP)

string · enumOptional

Model type enum for models.

Possible values:
or
nullOptional
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/models/{model_id}

Delete Model

delete

Delete a specific model by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
model_idstringRequired

The ID of the model to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/models/{model_id}

No content

Get Pipelines

get

Get a list of pipelines, optionally filtered by type (RAGO or DPO).

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
typesany ofOptional

The types of pipeline (optional)

or
nullOptional
typeany ofOptionalDeprecated

The type of pipeline (optional) (TODO: will be removed in the future)

string · enumOptionalPossible values:
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/pipelines

Create Pipeline

post

Create a new pipeline with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create pipeline request schema.

namestring · min: 3 · max: 100Required
typestring · enumRequired

The type of pipeline.

Values: RAGO. DPO. CSV.

Possible values:
display_namestring · min: 1 · max: 100Required
descriptionany ofOptional
stringOptional
or
nullOptional
is_activebooleanOptionalDefault: true
Responses
post
/admin/pipelines

Get Pipeline

get

Get details for a specific pipeline by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
pipeline_idstringRequired

The ID of the pipeline

Responses
chevron-right
200

Successful Response

application/json
get
/admin/pipelines/{pipeline_id}

Update Pipeline

put

Update an existing pipeline with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
pipeline_idstringRequired

The ID of the pipeline to update

Body

Update pipeline request schema.

nameany ofOptional
string · min: 3 · max: 100Optional
or
nullOptional
display_nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
descriptionany ofOptional
stringOptional
or
nullOptional
is_activeany ofOptional
booleanOptional
or
nullOptional
metadata_any ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/pipelines/{pipeline_id}

Delete Pipeline

delete

Delete a specific pipeline by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
pipeline_idstringRequired

The ID of the pipeline to delete

Responses
delete
/admin/pipelines/{pipeline_id}

No content

Get Pipeline Components

get

Get all pipeline components associated with a specific pipeline ID.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
pipeline_idstringRequired

The ID of the pipeline to get components for

Responses
chevron-right
200

Successful Response

application/json
get
/admin/pipeline-components

Create Pipeline Component

post

Create a new pipeline component with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create pipeline component request schema.

pipeline_idstring · min: 36 · max: 36Required
component_idstring · min: 36 · max: 36Required
Responses
post
/admin/pipeline-components

Get Pipeline Component

get

Get details for a specific pipeline component by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
pipeline_component_idstringRequired

The ID of the pipeline component

Responses
chevron-right
200

Successful Response

application/json
get
/admin/pipeline-components/{pipeline_component_id}

Update Pipeline Component

put

Update an existing pipeline component with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
pipeline_component_idstringRequired

The ID of the pipeline component to update

Body

Update pipeline component request schema.

pipeline_idstring · min: 36 · max: 36Required
component_idstring · min: 36 · max: 36Required
Responses
chevron-right
200

Successful Response

application/json
put
/admin/pipeline-components/{pipeline_component_id}

Delete Pipeline Component

delete

Delete a specific pipeline component by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
pipeline_component_idstringRequired

The ID of the pipeline component to delete

Responses
delete
/admin/pipeline-components/{pipeline_component_id}

No content

Load Value From Csv

post

Load value from csv file

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body
filestring · binaryRequired

CSV file to load values from

Responses
chevron-right
200

Successful Response

application/json
post
/admin/presets/csv

Get Presets

get

Get a list of presets, optionally filtered by pipeline ID.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
pipeline_idany ofOptional

Optional: The ID of the pipeline to get presets for

stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/presets

Create Preset

post

Create a new preset with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create preset with config fields request schema.

Attributes: pipeline_id (str): Pipeline ID (36 characters). pipeline_preset_id (str): Pipeline preset ID (1-100 characters). config_payload (list[ConfigPayload]): List of config payloads. user (CurrentUser | None, optional): Current user information. Defaults to None.

pipeline_idstring · min: 36 · max: 36Required
pipeline_preset_idstring · min: 1 · max: 100Required
userany ofOptional
or
nullOptional
Responses
post
/admin/presets

Get Preset

get

Get details for a specific preset by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
preset_idstringRequired

The ID of the preset

Responses
chevron-right
200

Successful Response

application/json
get
/admin/presets/{preset_id}

Update Preset

put

Update an existing preset with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
preset_idstringRequired

The ID of the preset to update

Body

Update preset request schema.

Attributes: pipeline_preset_id (str | None, optional): Pipeline preset ID (1-100 characters). Defaults to None. config_payload (list[ConfigPayload] | None, optional): List of config payloads. Defaults to None. user (CurrentUser | None, optional): Current user information. Defaults to None.

pipeline_preset_idany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
config_payloadany ofOptional
or
nullOptional
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/presets/{preset_id}

Delete Preset

delete

Delete a specific preset by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
preset_idstringRequired

The ID of the preset to delete

Responses
delete
/admin/presets/{preset_id}

No content

Get Rag Presets By Pipeline Id

get

Get all RAG (Retrieval-Augmented Generation) presets associated with a specific pipeline.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
pipeline_idstringRequired

The ID of the pipeline

Query parameters
searchany ofOptional

The search query

string · max: 100Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/presets/rag/{pipeline_id}

Get Dpo Presets By Pipeline Id

get

Get all DPO (Document Processing Orchestrator) presets associated with a specific pipeline.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
pipeline_idstringRequired

The ID of the pipeline

Query parameters
searchany ofOptional

The search query

string · max: 100Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/presets/dpo/{pipeline_id}

Get Prompt Builder Catalogs

get

Get a complete list of all prompt builder catalogs in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-builder-catalogs/all

Get Prompt Builder Catalog By Pipeline Id

get

Get a prompt builder catalog associated with a specific pipeline ID.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
pipeline_idstringRequired

The ID of the pipeline to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-builder-catalogs

Get Prompt Builder Catalog

get

Get details for a specific prompt builder catalog by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_builder_catalog_idstringRequired

The ID of the prompt builder catalog to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-builder-catalogs/{prompt_builder_catalog_id}

Update Prompt Builder Catalog

put

Update an existing prompt builder catalog with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_builder_catalog_idstringRequired

The ID of the prompt builder catalog to update

Body

Update prompt builder catalog request schema.

Attributes: name (str | None): The name of the prompt builder catalog. description (str | None): The description of the prompt builder catalog. is_override (bool | None): Whether the prompt builder catalog is an override of CHATBOT catalog. level (CatalogLevelType | None): The level of the prompt builder catalog. level_entity_id (str | None): The ID of the entity that the prompt builder catalog belongs to.

nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
descriptionany ofOptional
stringOptional
or
nullOptional
is_overrideany ofOptional
booleanOptional
or
nullOptional
levelany ofOptional
string · enum · min: 1 · max: 50Optional

Level type enum for catalogs.

Possible values:
or
nullOptional
level_entity_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/prompt-builder-catalogs/{prompt_builder_catalog_id}

Create Prompt Builder Catalog

post

Create a new prompt builder catalog with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create prompt builder catalog request schema.

Attributes: name (str): The name of the prompt builder catalog. description (str | None): The description of the prompt builder catalog. is_override (bool): Whether the prompt builder catalog is an override of CHATBOT catalog. level (CatalogLevelType): The level of the prompt builder catalog. level_entity_id (str | None): The ID of the entity that the prompt builder catalog belongs to.

namestring · min: 1 · max: 100Required
descriptionany ofOptional
stringOptional
or
nullOptional
is_overridebooleanOptionalDefault: false
levelstring · enum · min: 1 · max: 50Required

Level type enum for catalogs.

Possible values:
level_entity_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/prompt-builder-catalogs/

Get Prompt Builder Catalog Entry

get

Get details for a specific prompt builder catalog entry by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_builder_catalog_entry_idstringRequired

The ID of the prompt builder catalog entry to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-builder-catalog-entries/{prompt_builder_catalog_entry_id}

Update Prompt Builder Catalog Entry

put

Update an existing prompt builder catalog entry with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_builder_catalog_entry_idstringRequired

The ID of the prompt builder catalog entry to update

Body

Update prompt builder catalog entry request schema.

nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
scopeany ofOptional
stringOptional
or
nullOptional
typeany ofOptional
stringOptional
or
nullOptional
modelany ofOptional
stringOptional
or
nullOptional
system_instructionany ofOptional
stringOptional
or
nullOptional
user_instructionany ofOptional
stringOptional
or
nullOptional
prompt_template_group_idany ofOptional
stringOptional
or
nullOptional
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/prompt-builder-catalog-entries/{prompt_builder_catalog_entry_id}

Delete Prompt Builder Catalog Entry

delete

Delete a specific prompt builder catalog entry by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_builder_catalog_entry_idstringRequired

The ID of the prompt builder catalog entry to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/prompt-builder-catalog-entries/{prompt_builder_catalog_entry_id}

No content

Create Prompt Builder Catalog Entry

post

Create a new prompt builder catalog entry with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create prompt builder catalog entry request schema.

namestring · min: 1 · max: 100Required
prompt_builder_catalog_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
scopeany ofOptional
stringOptional
or
nullOptional
typestring · min: 1 · max: 100OptionalDefault: prompt_builder
modelany ofOptional
stringOptional
or
nullOptional
system_instructionany ofOptional
stringOptional
or
nullOptional
user_instructionany ofOptional
stringOptional
or
nullOptional
prompt_template_group_idany ofOptional
stringOptional
or
nullOptional
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/prompt-builder-catalog-entries

Get Prompt Template Groups

get

Get a complete list of all prompt template groups in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-template-groups/all

Get Prompt Template Group

get

Get details for a specific prompt template group by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_template_group_idstringRequired

The ID of the prompt template group to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-template-groups/{prompt_template_group_id}

Update Prompt Template Group

put

Update an existing prompt template group with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_template_group_idstringRequired

The ID of the prompt template group to update

Body

Update prompt template group request schema.

nameany ofOptional
string · min: 1 · max: 100Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/prompt-template-groups/{prompt_template_group_id}

Delete Prompt Template Group

delete

Delete a specific prompt template group by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_template_group_idstringRequired

The ID of the prompt template group to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/prompt-template-groups/{prompt_template_group_id}

No content

Create Prompt Template Group

post

Create a new prompt template group with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create prompt template group request schema.

namestring · min: 1 · max: 100Required
Responses
chevron-right
200

Successful Response

application/json
post
/admin/prompt-template-groups

Get Prompt Template Group Entries

get

Get a complete list of all prompt template group entries in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-template-group-entries/all

Get Prompt Template Group Entry

get

Get details for a specific prompt template group entry by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_template_group_entry_idstringRequired

The ID of the prompt template group entry to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-template-group-entries/{prompt_template_group_entry_id}

Update Prompt Template Group Entry

put

Update an existing prompt template group entry with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_template_group_entry_idstringRequired

The ID of the prompt template group entry to update

Body

Update prompt template group entry request schema.

model_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/prompt-template-group-entries/{prompt_template_group_entry_id}

Delete Prompt Template Group Entry

delete

Delete a specific prompt template group entry by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
prompt_template_group_entry_idstringRequired

The ID of the prompt template group entry to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/prompt-template-group-entries/{prompt_template_group_entry_id}

No content

Get Prompt Template Group Entry By Model Id

get

Get all prompt template group entries associated with a specific model ID.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
model_idstringRequired

The ID of the model to retrieve entries for

Responses
chevron-right
200

Successful Response

application/json
get
/admin/prompt-template-group-entries/model/{model_id}

Create Prompt Template Group Entry

post

Create a new prompt template group entry with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create prompt template group entry request schema.

prompt_template_group_idany ofOptional
string · min: 36 · max: 36Optional
or
nullOptional
model_idstring · min: 36 · max: 36Required
Responses
chevron-right
200

Successful Response

application/json
post
/admin/prompt-template-group-entries

Get Providers

get

Get a complete list of all available providers in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchany ofOptional

Search query for provider names

stringOptional
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/providers

Create Provider

post

Create a new provider with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Provider creation request schema.

Attributes: name (str): Unique identifier for the provider. display_name (str | None, optional): Display name for the provider. Defaults to None. icon (str | None, optional): Icon for the provider. Defaults to None. lm_invoker_type (str | None, optional): LM invoker type for the provider. Defaults to None. provider_kwargs (str | None, optional): Provider kwargs for the provider. Defaults to None. provider_env_kwargs (str | None, optional): Provider env kwargs for the provider. Defaults to None. is_active (bool, optional): Is the provider active. Defaults to True. user (CurrentUser | None, optional): Current user information. Defaults to None.

namestringRequired

Unique identifier for the provider

display_nameany ofOptional

Display name for the provider

stringOptional
or
nullOptional
iconany ofOptional

Icon for the provider

stringOptional
or
nullOptional
lm_invoker_typeany ofOptional

LM invoker type for the provider

stringOptional
or
nullOptional
provider_kwargsany ofOptional

Provider kwargs for the provider

stringOptional
or
nullOptional
provider_env_kwargsany ofOptional

Provider env kwargs for the provider

stringOptional
or
nullOptional
is_activebooleanOptional

Is the provider active

Default: true
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/providers

Get All Providers

get

Get a complete list of all available providers in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/providers/all

Get Provider

get

Get details for a specific provider by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
provider_idstringRequired

The ID of the provider to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/providers/{provider_id}

Update Provider

put

Update an existing provider with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
provider_idstringRequired

The ID of the provider to update

Body

Provider update request schema.

Attributes: name (str | None, optional): Unique identifier for the provider. Defaults to None. display_name (str | None, optional): Display name for the provider. Defaults to None. icon (str | None, optional): Icon for the provider. Defaults to None. lm_invoker_type (str | None, optional): LM invoker type for the provider. Defaults to None. provider_kwargs (str | None, optional): Provider kwargs for the provider. Defaults to None. provider_env_kwargs (str | None, optional): Provider env kwargs for the provider. Defaults to None. is_active (bool | None, optional): Is the provider active. Defaults to None. user (CurrentUser | None, optional): Current user information. Defaults to None.

nameany ofOptional

Unique identifier for the provider

stringOptional
or
nullOptional
display_nameany ofOptional

Display name for the provider

stringOptional
or
nullOptional
iconany ofOptional

Icon for the provider

stringOptional
or
nullOptional
lm_invoker_typeany ofOptional

LM invoker type for the provider

stringOptional
or
nullOptional
provider_kwargsany ofOptional

Provider kwargs for the provider

stringOptional
or
nullOptional
provider_env_kwargsany ofOptional

Provider env kwargs for the provider

stringOptional
or
nullOptional
is_activeany ofOptional

Is the provider active

booleanOptional
or
nullOptional
userany ofOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/providers/{provider_id}

Delete Provider

delete

Delete a specific provider by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
provider_idstringRequired

The ID of the provider to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/providers/{provider_id}

No content

Get Resource Quotas

get

Get all resource quotas for tenant

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/resource-quotas

Update Multiple Resource Quotas

patch

Update multiple resource quota values

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body
Other propertiesintegerOptional
Responses
chevron-right
200

Successful Response

application/json
patch
/admin/resource-quotas

Update Resource Quota

patch

Update resource quota value

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
quota_namestring · enumRequired

Enum for quota names.

Possible values:
Body

Request schema for updating resource quota.

Attributes: value (int): The new quota value (0-1M).

valueinteger · max: 1000000000Required

New quota value (0-1M)

Responses
chevron-right
200

Successful Response

application/json
patch
/admin/resource-quotas/{quota_name}

Get Roles

get

Get a complete list of all roles available in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/v2/roles
Deprecated

Get Roles Old

get

Get a complete list of all roles available in the system.This endpoint is deprecated and will be removed in the future.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/roles

Get Subscriptions

get

Get all subscriptions

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchstringOptional

Search query for subscription names

pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/subscriptions

Get Subscription By Current Tenant

get

Get a subscription by current tenant

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/subscriptions/current

Get Subscription

get

Get a subscription by id

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
organization_idstringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/subscriptions/{organization_id}

Get System Settings

get

Get a list of system settings.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
is_publicany ofOptional

Filter by public settings

booleanOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/system-settings

Get System Setting By Key

get

Get a system setting by its key.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
keystring · enumRequired

The key of the system setting

Possible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/system-settings/key/{key}

Get System Setting

get

Get a system setting by its ID.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
setting_idstringRequired

The ID of the system setting

Responses
chevron-right
200

Successful Response

application/json
get
/admin/system-settings/{setting_id}

Update System Setting

put

Update an existing system setting.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
setting_idstringRequired

The ID of the system setting to update

Body

Update system setting request schema.

valueany ofOptional
stringOptional
or
nullOptional
descriptionany ofOptional
stringOptional
or
nullOptional
is_publicany ofOptional
booleanOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/system-settings/{setting_id}

Get users with pagination

get

Get a paginated list of users

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchany ofOptional

The username to search for

string · min: 3Optional
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/users

Create user

post

Create a new user

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

User create model.

idany ofOptional
stringOptional
or
nullOptional
usernamestringRequired
providerstring · enumRequired

Admin user provider.

Possible values:
passwordany ofOptional
stringOptional
or
nullOptional
password_hashany ofOptional
stringOptional
or
nullOptional
display_nameany ofOptional
stringOptional
or
nullOptional
pictureany ofOptional
stringOptional
or
nullOptional
emailany ofOptional
stringOptional
or
nullOptional
is_verifiedbooleanOptionalDefault: false
is_activebooleanOptionalDefault: true
rolesstring[]Optional

Roles for the user

Responses
post
/admin/users

Get all users

get

Get all users without pagination

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/users/all

Get user by ID

get

Get a user by ID

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_idstring · min: 1Required

User ID

Responses
chevron-right
200

Successful Response

application/json
get
/admin/users/{user_id}

Update user

put

Update a user by ID

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_idstring · min: 1Required

User ID

Body

User update model.

usernameany ofOptional
stringOptional
or
nullOptional
passwordany ofOptional
stringOptional
or
nullOptional
display_nameany ofOptional
stringOptional
or
nullOptional
pictureany ofOptional
stringOptional
or
nullOptional
emailany ofOptional
stringOptional
or
nullOptional
is_verifiedany ofOptional
booleanOptional
or
nullOptional
is_activebooleanOptionalDefault: true
rolesstring[]Optional

Roles for the user

auth_idany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/users/{user_id}

Delete user

delete

Delete a user by ID

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_idstring · min: 1Required

User ID

Responses
delete
/admin/users/{user_id}

No content

Bulk update user status

post

Bulk update user status for multiple users

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Bulk user update status model.

user_account_idsstring[]Required
is_activebooleanRequired
Responses
chevron-right
200

Successful Response

application/json
post
/admin/users/bulk-update-status
Deprecated

Get User Accounts Page

get

Get a paginated list of all user accounts with optional search filtering by username.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
searchany ofOptional

The username to search for

string · min: 3Optional
or
nullOptional
pageinteger · min: 1OptionalDefault: 1
sizeinteger · min: 1 · max: 100OptionalDefault: 10
sort_byany ofOptional
stringOptional
or
nullOptional
sort_directionstring · enumOptional

Sort order enum.

Default: ascPossible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/user-accounts
Deprecated

Create User Account

post

Create a new user account with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

User account create model revamp.

usernamestringRequired
providerstring · enumRequired

User account provider.

Possible values:
display_nameany ofOptional
stringOptional
or
nullOptional
domainany ofOptional
stringOptional
or
nullOptional
passwordany ofOptional
stringOptional
or
nullOptional
is_activebooleanOptionalDefault: true
pictureany ofOptional
stringOptional
or
nullOptional
provider_account_idany ofOptional
stringOptional
or
nullOptional
rolesstring[]Optional

Roles for the user

Responses
chevron-right
200

Successful Response

application/json
post
/admin/user-accounts
Deprecated

Bulk Update User Account Status

post

Update the status of multiple user accounts in a single operation.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Bulk user account update status model.

user_account_idsstring[]Required
is_activebooleanRequired
Responses
chevron-right
200

Successful Response

application/json
post
/admin/user-accounts/bulk-update-status
Deprecated

Get User Accounts

get

Get a complete list of all user accounts in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/user-accounts/all
Deprecated

Get User Account

get

Get details for a specific user account by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_account_idstringRequired
Responses
chevron-right
200

Successful Response

application/json
get
/admin/user-accounts/{user_account_id}
Deprecated

Update User Account

put

Update an existing user account with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_idstringRequired
Body

User account update model revamp.

usernameany ofOptional
stringOptional
or
nullOptional
passwordany ofOptional
stringOptional
or
nullOptional
display_nameany ofOptional
stringOptional
or
nullOptional
pictureany ofOptional
stringOptional
or
nullOptional
is_activebooleanOptionalDefault: true
rolesstring[]Optional

Roles for the user

Responses
chevron-right
200

Successful Response

application/json
put
/admin/user-accounts/{user_id}
Deprecated

Delete User Account

delete

Delete a specific user account by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_idstringRequired
Responses
chevron-right
200

Successful Response

application/json
delete
/admin/user-accounts/{user_id}

Get All User Domains

get

Get a complete list of all user domains in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/user-domains/all

Get User Domain By Id

get

Get details for a specific user domain by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_domain_idstringRequired

The ID of the user domain to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/user-domains/{user_domain_id}

Update User Domain

put

Update an existing user domain with the provided data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_domain_idstringRequired

The ID of the user domain to update

Body

Update User Domain request model.

nameany ofOptional
stringOptional
or
nullOptional
domainany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/user-domains/{user_domain_id}

Delete User Domain

delete

Delete a specific user domain by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
user_domain_idstringRequired

The ID of the user domain to delete

Responses
delete
/admin/user-domains/{user_domain_id}

No content

Create User Domain

post

Create a new user domain with the provided data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create User Domain request model.

namestringRequired
domainstringRequired
Responses
post
/admin/user-domains

Get Vector Stores

get

Get a complete list of all vector stores in the system.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/vector-stores

Create Vector Store

post

Create a new vector store with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Body

Create vector store request schema.

knowledge_base_idstring · min: 36 · max: 36Required
vector_store_idintegerRequired
authany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/vector-stores

Get Vector Store

get

Get details for a specific vector store by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
vector_store_idstringRequired

The ID of the vector store to retrieve

Responses
chevron-right
200

Successful Response

application/json
get
/admin/vector-stores/{vector_store_id}

Update Vector Store

put

Update an existing vector store with the provided configuration data.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
vector_store_idstringRequired

The ID of the vector store to update

Body

Update vector store request schema.

vector_store_idany ofOptional
integerOptional
or
nullOptional
authany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/vector-stores/{vector_store_id}

Delete Vector Store

delete

Delete a specific vector store by its unique identifier.

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
vector_store_idstringRequired

The ID of the vector store to delete

Responses
chevron-right
200

Successful Response

application/json
Responseany
delete
/admin/vector-stores/{vector_store_id}

No content

Get Providers

get

Get all providers

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
get
/admin/whatsapp/providers

Get Provider Config By Type

get

Get provider configurations

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
provider_typestring · enumRequired

The provider type (qiscus or twilio)

Possible values:
Responses
chevron-right
200

Successful Response

application/json
get
/admin/whatsapp/providers/{provider_type}

Configure Provider

put

Configure a WhatsApp provider

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
provider_typestring · enumRequired

The provider type (qiscus or twilio)

Possible values:
Body

The configuration request

client_idstringRequired
client_secretstringRequired
Responses
chevron-right
200

Successful Response

application/json
put
/admin/whatsapp/providers/{provider_type}

Add Phone Number

post

Add a phone number to a WhatsApp provider

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
provider_typestring · enumRequired

The provider type (qiscus or twilio)

Possible values:
Body

Request schema for adding a phone number.

Attributes: phone_number (str): The phone number in E.164 format. display_name (str | None): Optional display name for the phone number. provider_metadata (dict[str, Any] | None): Provider-specific metadata.

phone_numberstringRequired

Phone number in E.164 format

Pattern: ^\+[1-9]\d{1,14}$
display_nameany ofOptional

Optional display name for the phone number

stringOptional
or
nullOptional
provider_metadataany ofOptional

Provider-specific metadata (e.g., channel_id for Qiscus)

or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/whatsapp/providers/{provider_type}/phone-numbers

Get Phone Numbers

get

Get phone numbers with optional filtering

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Query parameters
providerany ofOptional

Filter by provider type

string · enumOptional

Provider type enumeration.

Possible values:
or
nullOptional
is_activeany ofOptional

Filter by active status

booleanOptional
or
nullOptional
include_chatbotsbooleanOptional

Include associated chatbots

Default: false
searchstringOptional

Search query for phone number

Responses
chevron-right
200

Successful Response

application/json
get
/admin/whatsapp/phone-numbers

Get Phone Number By Id

get

Get a phone number by ID

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
phone_number_idstringRequired

The phone number ID

Responses
chevron-right
200

Successful Response

application/json
get
/admin/whatsapp/phone-numbers/{phone_number_id}

Update Phone Number

put

Update a phone number

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
phone_number_idstringRequired

The phone number ID

Body

Request schema for updating a phone number.

Attributes: phone_number (str): The phone number in E.164 format. display_name (str | None): Optional display name for the phone number. is_active (bool | None): Whether the phone number is active. provider_metadata (dict[str, Any] | None): Provider-specific metadata.

phone_numberstringRequired

Phone number in E.164 format

Pattern: ^\+[1-9]\d{1,14}$
display_nameany ofOptional

Optional display name for the phone number

stringOptional
or
nullOptional
is_activeany ofOptional

Whether the phone number is active

booleanOptional
or
nullOptional
provider_metadataany ofOptional

Provider-specific metadata (e.g., channel_id for Qiscus)

or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
put
/admin/whatsapp/phone-numbers/{phone_number_id}

Remove Phone Number

delete

Remove a phone number

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
phone_number_idstringRequired

The phone number ID

Responses
delete
/admin/whatsapp/phone-numbers/{phone_number_id}

No content

Assign Phone Number To Chatbot

post

Assign a phone number to a chatbot

Authorizations
OAuth2passwordRequired
Token URL:
cookie
__Secure-next-auth.session-tokenany ofOptional
stringOptional
or
nullOptional
Path parameters
chatbot_idstringRequired

The chatbot ID

Body

Request schema for assigning a phone number to a chatbot.

Attributes: phone_number_id (str | None): The phone number ID. Defaults to None.

phone_number_idany ofOptional
stringOptional
or
nullOptional
Responses
chevron-right
200

Successful Response

application/json
post
/admin/whatsapp/chatbots/{chatbot_id}/assign

Last updated