Apps

App related APIs

Get List Apps

get

Get a list of apps. The apps are sorted by weight in descending order by default.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Query parameters

searchTermany ofOptional

Search term for app name or description

stringOptional

or

nullOptional

categoriesany ofOptional

Filter by app categories

string[]Optional

or

nullOptional

typeany ofOptional

Filter by app type

stringOptional

or

nullOptional

publishedany ofOptional

Filter by published status

booleanOptional

or

nullOptional

pageSizeinteger · min: 1 · max: 100Optional

Number of apps per page

Default: 50

cursorany ofOptional

Cursor for pagination

stringOptional

or

nullOptional

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

OK

application/json

get

/webapi/v2/apps

HTTPcURLJavaScriptPython

GET /webapi/v2/apps HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

200

OK

{
  "apps": [
    {
      "id": "text",
      "name": "text",
      "description": "text",
      "type": "text",
      "category": "text",
      "published": true,
      "agentPermission": {
        "accessAgents": [
          {
            "agentId": "text",
            "accessType": "order_1_editor"
          }
        ],
        "accessPermissionGroups": [
          {
            "permissionGroupId": "text",
            "permissionGroupName": "text",
            "accessType": "order_1_editor"
          }
        ],
        "viewAccessToAgent": true
      },
      "userPermission": {
        "ownUserIds": [
          "text"
        ],
        "customerGroups": [
          "text"
        ],
        "viewAccessToUser": true
      }
    }
  ],
  "cursor": "text"
}

Get App By Id

get

Get a specific app by ID.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

app_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

OK

application/json

get

/webapi/v2/apps/{app_id}

HTTPcURLJavaScriptPython

GET /webapi/v2/apps/{app_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

200

OK

{
  "id": "text",
  "name": "text",
  "description": "text",
  "type": "text",
  "category": "text",
  "published": true,
  "agentPermission": {
    "accessAgents": [
      {
        "agentId": "text",
        "accessType": "order_1_editor"
      }
    ],
    "accessPermissionGroups": [
      {
        "permissionGroupId": "text",
        "permissionGroupName": "text",
        "accessType": "order_1_editor"
      }
    ],
    "viewAccessToAgent": true
  },
  "userPermission": {
    "ownUserIds": [
      "text"
    ],
    "customerGroups": [
      "text"
    ],
    "viewAccessToUser": true
  }
}

Update App

patch

Update an app.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

app_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

Request schema for updating an app.

nameany ofOptional

Name of the app

stringOptional

or

nullOptional

descriptionany ofOptional

Description of the app

stringOptional

or

nullOptional

categoryany ofOptional

Category of the app

stringOptional

or

nullOptional

publishedany ofOptional

Whether the app is published

booleanOptional

or

nullOptional

agentPermissionany ofOptional

Agent permission

or

nullOptional

userPermissionany ofOptional

User permission

or

nullOptional

Responses

200

OK

application/json

patch

/webapi/v2/apps/{app_id}

HTTPcURLJavaScriptPython

PATCH /webapi/v2/apps/{app_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 359

{
  "name": "text",
  "description": "text",
  "category": "text",
  "published": true,
  "agentPermission": {
    "accessAgents": [
      {
        "agentId": "text",
        "accessType": "order_1_editor"
      }
    ],
    "accessPermissionGroups": [
      {
        "permissionGroupId": "text",
        "accessType": "order_1_editor"
      }
    ],
    "viewAccessToAgent": true
  },
  "userPermission": {
    "ownUserIds": [
      "text"
    ],
    "customerGroups": [
      "text"
    ],
    "viewAccessToUser": true
  }
}

200

OK

{
  "id": "text",
  "name": "text",
  "description": "text",
  "type": "text",
  "category": "text",
  "published": true,
  "agentPermission": {
    "accessAgents": [
      {
        "agentId": "text",
        "accessType": "order_1_editor"
      }
    ],
    "accessPermissionGroups": [
      {
        "permissionGroupId": "text",
        "permissionGroupName": "text",
        "accessType": "order_1_editor"
      }
    ],
    "viewAccessToAgent": true
  },
  "userPermission": {
    "ownUserIds": [
      "text"
    ],
    "customerGroups": [
      "text"
    ],
    "viewAccessToUser": true
  }
}

get

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Query parameters

publishedstringOptional

idstring[]Optional

localestringOptional

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Responses

200

앱 API 성공 답변 받기

application/json

get

/webapi/apps

HTTPcURLJavaScriptPython

GET /webapi/apps HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Accept: */*

200

앱 API 성공 답변 받기

{
  "result": [
    {
      "id": "text",
      "name": "text",
      "type": "single_action",
      "description": "text",
      "category": "text",
      "app_from": "text",
      "app_url": "text"
    }
  ]
}

post

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

user_idstringOptional

typestring · enumRequiredPossible values:

namestringRequired

descriptionstringRequired

categorystringRequired

publishedbooleanRequired

enabledbooleanRequired

Responses

200

앱 API 성공 답변 생성

application/json

post

/webapi/apps

HTTPcURLJavaScriptPython

POST /webapi/apps HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 472

{
  "user_id": "text",
  "type": "single_action",
  "name": "text",
  "description": "text",
  "category": "text",
  "published": true,
  "enabled": true,
  "single_action_app_input": {
    "name": "text",
    "description": "text",
    "llm_model": "text",
    "selected_llm_processing_method": "stuff",
    "selected_map_reduce_input_variable_name": "text",
    "inputs": [
      {
        "name": "text",
        "value": "text",
        "placeholder": "text",
        "input_type": "text",
        "options": [
          {
            "name": "text",
            "value": "text"
          }
        ]
      }
    ],
    "messages": [
      {
        "role": "system",
        "content": "text"
      }
    ]
  }
}

200

앱 API 성공 답변 생성

{
  "result": {
    "id": "text"
  }
}

Run LLM App

post

Execute an LLM App via REST API. Supports JSON requests.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Path parameters

app_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

modestring · enumOptional

Execution mode. Use "sync" for synchronous responses or "stream" for streaming responses. Default is "sync".

Default: syncPossible values:

isStatefulbooleanOptional

Whether to maintain conversation state. Set to true to enable conversation history. When true, conversationId must be provided for follow-up messages.

Default: false

conversationIdstringOptional

Conversation ID for continuing a previous conversation. Required when isStateful is true for follow-up messages. Use the conversation.id from the previous response.

llmModelstringOptional

Name of the LLM model to use. Must be a registered model name (lowercase). See model registration documentation for available models.

llmPromptIdstringOptional

ID of the LLM prompt to use

gaPromptGroupIdstringOptional

ID of the Generative Answer prompt group to use

temperaturenumberOptional

Controls the randomness of the output. Higher values make the output more random. Range is typically 0 to 2.

Default: 0

requiredVariablesstring[]Optional

List of required variable names to include in the response

Responses

200

Successfully executed the LLM App

application/json

400

Bad request

401

Unauthorized - Invalid or missing authentication token

429

Rate limit exceeded

500

Internal server error

post

/webapi/apps/{app_id}/run

HTTPcURLJavaScriptPython

POST /webapi/apps/{app_id}/run HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 321

{
  "chat": {
    "message": "text",
    "source": {
      "knowledgeBaseIds": [
        "text"
      ],
      "folderIds": [
        "text"
      ],
      "webSites": [
        "text"
      ]
    }
  },
  "inputs": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "mode": "sync",
  "isStateful": false,
  "conversationId": "text",
  "llmModel": "text",
  "llmPromptId": "text",
  "gaPromptGroupId": "text",
  "temperature": 0,
  "requiredVariables": [
    "text"
  ]
}

{
  "result": {
    "id": "text",
    "name": "text",
    "type": "campaign",
    "category": "General",
    "responses": [
      {
        "id": "text",
        "type": "text",
        "message": "text",
        "source": {},
        "sender": "text",
        "createdAt": "2024-09-23T04:53:12.675",
        "completed": true,
        "citations": [
          {
            "clueId": "text",
            "source": "text",
            "title": "text",
            "knowledgeBaseId": "text",
            "pageNo": 1,
            "url": "text",
            "text": "text"
          }
        ],
        "error": {
          "timestamp": 1,
          "nodeId": "text",
          "nodeType": "text",
          "errorType": "text",
          "errorObject": {}
        },
        "intermediateStep": {
          "completed": true,
          "key": "text",
          "createdAt": "2025-12-15T21:35:45.243Z",
          "statusMessage": "text",
          "markdownMessage": "text"
        }
      }
    ],
    "variables": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "conversation": {
      "id": "text",
      "state": "text"
    }
  },
  "error": "text"
}

기술 실행

post

이 API는 스킬을 실행하고 최종 텍스트 답변을 JSON 포맷으로 반환합니다. 이 API는 스킬이 그 목적을 위해 설계된 경우 엔티티 추출에 사용할 수 있습니다.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

idstringRequired

스킬 ID입니다. Alli 대시보드에서 스킬을 클릭하면 URL이 https://app.alli.ai/projects/PROJECT_ID/campaigns/SKILL_ID와 같이 표시됩니다. 여기에 SKILL_ID를 입력해 주세요.

textstringRequired

기술 실행을 위한 입력 텍스트입니다.

variablesobjectOptional

변수는 스킬의 변수를 설정하기 위한 JSON 객체입니다. Alli에서 변수에 대해 더 알아보려면 유저 가이드를 True조해 주세요.

Responses

200

성공적으로 실행되었습니다.

application/json

400

잘못된 요청

application/json

401

허가되지 않음

application/json

post

/webapi/skill

HTTPcURLJavaScriptPython

POST /webapi/skill HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "id": "text",
  "text": "text",
  "variables": {}
}

{
  "result": "text",
  "errors": [
    "text"
  ]
}

생성 답변 API

post

생성적 답변 API는 비정형 텍스트 문서, Q&A, 심지어 복잡한 표에서도 답을 찾습니다. 여러 출처에서 정보를 종합하여 유저 쿼리에 대한 포괄적인 답변을 제공합니다.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

querystringOptional

쿼리 문자열입니다.

modelstringOptional

답변을 생성할 때 선택한 LLM을 활용하십시오. 기본 모델은 GPT4o입니다. 사용 가능한 옵션은 문서를 True로 변경하십시오.

answerFormatstringOptional

답변의 형식을 결정하여 통합을 용이하게 만듭니다. 허용 가능한 값은 DRAFTJS 및 MARKDOWN입니다. 기본 형식은 DRAFTJS입니다.

isStatefulbooleanOptional

후속 질문을 사용하기 위해서는 이전 대화 역사가 필요합니다. 대화 역사는 threadId로 관리됩니다. isStateful 옵션을 True로 설정하고 threadId를 입력하면 이전 대화 역사를 True고하여 쿼리가 다시 작성됩니다. 기본값 = False.

threadIdstring · uuidOptional

threadId는 isStateful = True일 때 사용됩니다. 처음 대화를 시작할 때는 비워서 보내고, 그 다음 질의부터는 출력에서 threadId를 사용하여 보냅니다. 그러나 처음부터 threadId를 설정하려면 UUID로 작성하여 보내십시오. 예시 UUID - 36e7bb2b-1063-47ec-. 기본값 = None.

promptGroupIdstringOptional

프로젝트에서 답변 생성에 사용할 그룹 프롬프트를 선택해 주세요. ID는 설정 페이지 내에서 그룹 프롬프트를 볼 때 URL에 위치해 있습니다. 이는 특정 작업을 위해 수정된 여러 다른 그룹 프롬프트가 있는 프로젝트에 매우 유용한 옵션입니다.

modestringOptional

데이터를 스트림 또는 동기식으로 출력할지 여부. 현재 사용 가능한 값: sync 또는 stream (기본값=sync). 스트림 모드에서는 .json 문자열이 동기식과 동일한 출력 형식으로 스트리밍으로 출력됩니다.

clueTextbooleanOptional

단서를 사용하여 단서로 사용된 문서의 텍스트를 포함할지 여부. 기본값 = False. 단서가 활성화된 경우에만 작동합니다.

cluesbooleanOptional

출력에 생성 답변을 만드는 데 사용될 단서를 포함할지 여부. 기본값 = False.

includeCitationsbooleanOptional

Whether to include detailed citation information in the response. Citations provide structured references to source documents used in generating the answer. Default = False.

search_fromstring[]Optional

생성적 답변이 데이터를 찾기 위한 원본 데이터의 범위를 지정합니다. 현재 사용 가능한 값은 다음과 같습니다: 웹, 질의답변, 문서이며, 목록 형식으로 데이터를 입력합니다. 예를 들어 -> ["웹", "질의답변"]

temperaturenumberOptional

출력의 무작위성을 제어합니다. 값이 클수록 출력이 더 무작위가 됩니다. 기본값 = 0.

knowledgeBaseIdsstring[]Optional

검색을 특정 지식베이스 ID로 제한합니다.

folderIdsstring[]Optional

검색을 특정 폴더 ID로 제한합니다.

Responses

200

성공적으로 생성된 답변

application/json

400

잘못된 요청

application/json

401

무단의

application/json

429

속도 제한 초과

application/json

post

/webapi/generative_answer

HTTPcURLJavaScriptPython

POST /webapi/generative_answer HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 609

{
  "query": "text",
  "model": "text",
  "answerFormat": "text",
  "isStateful": true,
  "threadId": "123e4567-e89b-12d3-a456-426614174000",
  "promptGroupId": "text",
  "mode": "text",
  "clueText": true,
  "clues": true,
  "includeCitations": true,
  "hashtags": {
    "qnaInclude": [
      "text"
    ],
    "qnaIncludeOption": "or",
    "qnaExclude": [
      "text"
    ],
    "qnaExcludeOption": "or",
    "docsInclude": [
      "text"
    ],
    "docsIncludeOption": "or",
    "docsExclude": [
      "text"
    ],
    "docsExcludeOption": "or"
  },
  "search_from": [
    "text"
  ],
  "temperature": 1,
  "source": {
    "sharedKnowledgeBaseNodeIds": [
      "text"
    ],
    "personalKnowledgeBaseNodeIds": [
      "text"
    ],
    "webSites": [
      "text"
    ]
  },
  "knowledgeBaseIds": [
    "text"
  ],
  "folderIds": [
    "text"
  ]
}

{
  "answer": {},
  "answerHash": "text",
  "confidence": 1,
  "effectiveConfidence": 1,
  "documentId": "text",
  "documentName": "text",
  "hashtags": [],
  "pageNo": 1,
  "createdDate": "2025-12-15",
  "agentFeedback": {},
  "userFeedback": {},
  "body": "text",
  "css": "text",
  "pdfPreview": "text",
  "folder": "text",
  "editor": [
    "text"
  ],
  "viewer": [
    "text"
  ],
  "threadId": "text",
  "fuQuestion": "text",
  "intent": "text",
  "clues": [],
  "citations": [
    {
      "index": 1,
      "clueId": "text",
      "source": "text",
      "title": "text",
      "pageNo": 1,
      "knowledgeBaseId": "text",
      "faqId": "text",
      "url": "text",
      "text": "text"
    }
  ]
}

대화 시작

post

스킬을 사용하여 대화를 시작하십시오. True고: 이 엔드포인트는 현재 메시지 노드, Q&A 노드 및 문서 노드와만 호환됩니다.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

placementstringOptional

어떤 스킬로 대화를 시작할지 매칭하는 데 사용됩니다.

Responses

200

성공적으로 대화를 시작했습니다.

application/json

post

/webapi/start_conversation

HTTPcURLJavaScriptPython

POST /webapi/start_conversation HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "placement": "text"
}

200

성공적으로 대화를 시작했습니다.

{
  "result": {
    "conversation": {
      "id": "text",
      "project": {
        "nluLanguage": "text"
      },
      "chats": {
        "edges": [
          {
            "node": {
              "id": "text",
              "message": "text",
              "createdAt": 1,
              "chatOptionInfos": [
                {
                  "shortenOption": "text",
                  "longOption": "text",
                  "style": {
                    "bgColor": "text",
                    "bold": true,
                    "fontColor": "text",
                    "italic": true,
                    "lineColor": "text",
                    "underline": true
                  },
                  "meta": "text"
                }
              ],
              "isDeleted": true
            }
          }
        ]
      }
    }
  },
  "errors": {}
}

End Conversation by Agent

post

End a conversation from the agent side.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

idstringRequired

The conversation ID to end

Responses

200

Conversation ended successfully

application/json

post

/webapi/end_conversation_by_agent

HTTPcURLJavaScriptPython

POST /webapi/end_conversation_by_agent HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "id": "text"
}

200

Conversation ended successfully

{
  "result": {
    "conversation": {
      "id": "text",
      "completedTime": 1,
      "state": "text",
      "__typename": "text"
    },
    "__typename": "text"
  },
  "errors": {}
}

대화 보내기

post

기존 대화에 대해 유저로 메시지를 보냅니다. True고: 이 엔드포인트는 현재 메시지 노드, Q&A 노드 및 문서 노드와만 호환됩니다.

Authorizations

ApiKeyAuthTokenAuthProjectIdHeader

API-KEYstringRequired

Your API key for authentication

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

application/json

messagestringRequired

대화에서 보낼 메시지. null이거나 빈 문자열일 수 없습니다.

conversationIdstringRequired

메시지를 보내고자 하는 대화의 고유 ID입니다.

Responses

200

대화 전송 성공

application/json

post

/webapi/send_chat

HTTPcURLJavaScriptPython

POST /webapi/send_chat HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "message": "text",
  "conversationId": "text"
}

200

대화 전송 성공

{
  "result": {
    "responses": [
      {
        "id": "text",
        "message": "text",
        "createdAt": 1,
        "chatOptionInfos": [
          {
            "shortenOption": "text",
            "longOption": "text",
            "style": {
              "bgColor": "text",
              "bold": true,
              "fontColor": "text",
              "italic": true,
              "lineColor": "text",
              "underline": true
            },
            "meta": "text"
          }
        ],
        "isDeleted": true
      }
    ],
    "state": "text"
  },
  "errors": {}
}