v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-25173140700.7 KB

Application

Create an application

Create a new application (superadmin only).

post/applications/

Query parameters

cookie_namestring nullable

Request body

namestring required

Display name of the application.

is_activeboolean

Whether the application is active and available to users.

tenant_idinteger required

ID of the tenant the application belongs to.

app_urlstring nullable

URL where an external (non-native) application is hosted.

is_nativeboolean nullable

Whether the application is a native, built-in application.

native_app_idinteger nullable

Identifier of the native application, when is_native is true.

descriptionstring nullable

Optional description of what the application does.

versionstring nullable

Version string of the application.

avatarstring nullable

URL or identifier of the application's avatar image.

Example request

{
  "name": "Knowledge Assistant",
  "is_active": true,
  "tenant_id": 1,
  "app_url": "https://apps.example.com/assistant",
  "native_app_id": 10,
  "description": "Answers questions over the company knowledge base.",
  "version": "1.0.0",
  "avatar": "https://cdn.example.com/avatars/assistant.png"
}

Response

Successful Response

{"stackTrail":"paths:/applications/:post:responses:201:content:application/json:schema","oasType":"schema","type":"unknown"}