Auralis Public API documentation (1.0.24)

Auralis Core Chat Flow

Initiate Core Chat

This endpoint initiates an Core chat session within the AE system. The chat is configured based on the provided parameters and request body. The client can specify a preferred language for the session, though it's optional. The response will contain the chat's outcome or any relevant error information if the request fails.

path Parameters
widgetId
required
string

The ID of a specific widget.

chatId
required
string

The ID of a specific chat session within the widget.

query Parameters
language
string
Example: language=en

The language code (e.g., 'en' for English, 'es' for Spanish) to be used in the chat session. If not specified, the default language will be used.

Request Body schema: application/json
required
message
required
string

The message content.

message_origin
string
Default: "copilot"

Origin of the message, defaulting to 'copilot'.

object (UserData)

Schema for additional user information that is optional.

Responses

Request samples

Content type
application/json
{
  • "message": "string",
  • "message_origin": "copilot",
  • "user_data": {
    }
}

Response samples

Content type
application/json
{
  • "prompt": "string",
  • "text": "string",
  • "documents": [
    ],
  • "route": "string",
  • "widget_id": "string",
  • "conversation_id": "string",
  • "chat_history": {
    },
  • "language": "string"
}

Initiate Core Chat with Azure

This endpoint initiates an Core chat session utilizing Azure's services within the AE system. The chat interaction is configured based on the data provided in the request body. The response will provide details of the chat session or error information if the request fails.

path Parameters
widgetId
required
string

The ID of a specific widget.

chatId
required
string

The ID of a specific chat session within the widget.

query Parameters
language
string
Example: language=en

The language code (e.g., 'en' for English, 'es' for Spanish) to be used in the chat session. If not specified, the default language will be used.

Request Body schema: application/json
required
message
required
string

The message content.

message_origin
string
Default: "copilot"

Origin of the message, defaulting to 'copilot'.

object (UserData)

Schema for additional user information that is optional.

Responses

Request samples

Content type
application/json
{
  • "message": "string",
  • "message_origin": "copilot",
  • "user_data": {
    }
}

Response samples

Content type
application/json
{
  • "prompt": "string",
  • "text": "string",
  • "documents": [
    ],
  • "route": "string",
  • "widget_id": "string",
  • "conversation_id": "string",
  • "chat_history": {
    },
  • "language": "string"
}

Auralis Zendesk Flow

Create a Ticket on Zendesk

This endpoint creates a new support ticket on Zendesk within the AE system. The request body must include the necessary details for the ticket, such as the issue description and relevant user information. Upon successful creation, the response will include the ticket ID and its status on Zendesk. If the request is invalid or fails, appropriate error responses will be returned.

path Parameters
widgetId
required
string

The ID of a specific widget.

chatId
required
string

The ID of a specific chat session within the widget.

Request Body schema: application/json
required
username
required
string
email
required
string
description
required
string
connection_id
string
Default: ""

Responses

Request samples

Content type
application/json
{
  • "username": "string",
  • "email": "string",
  • "description": "string",
  • "connection_id": ""
}

Response samples

Content type
application/json
{
  • "ticket_id": "string",
  • "status": "string"
}

Initiate Agent Handoff Session

This endpoint initiates an agent handoff session within Zendesk via the AE system. It allows for the seamless transition of a conversation from an automated system to a human agent. The request body must include the details required to create a support ticket, which will be used to inform the agent about the ongoing issue. A successful response will contain details about the handoff session, ensuring that the human agent has the context needed to continue the interaction. If the request fails, appropriate error information will be returned.

path Parameters
widgetId
required
string

The ID of a specific widget.

chatId
required
string

The ID of a specific chat session within the widget.

Request Body schema: application/json
required
username
required
string
email
required
string
description
required
string
connection_id
string
Default: ""

Responses

Request samples

Content type
application/json
{
  • "username": "string",
  • "email": "string",
  • "description": "string",
  • "connection_id": ""
}

Response samples

Content type
application/json
{
  • "session_id": "string",
  • "status": "string"
}

Send a Message to an Agent

This endpoint allows users to send a message directly to a human agent within the Auralis Core Chat Flow system. The message content and any related metadata must be provided in the request body. Upon successful processing, the response will include details of the sent message, confirming its delivery to the agent. If the request is malformed or contains invalid data, the appropriate error information will be returned.

path Parameters
widgetId
required
string

The ID of a specific widget.

chatId
required
string

The ID of a specific chat session within the widget.

Request Body schema: application/json
required
message
required
string
email
required
string

Responses

Request samples

Content type
application/json
{
  • "message": "string",
  • "email": "string"
}

Response samples

Content type
application/json
{
  • "message_id": "string",
  • "status": "string"
}

Receive Zendesk Webhook Notifications

This endpoint is designed to receive and process webhook notifications from Zendesk. The request body should contain the payload sent by Zendesk, which may include information about ticket updates, user activities, or other events. The server will handle these notifications to integrate Zendesk updates into the Auralis Core Chat Flow system. The response will confirm receipt of the webhook notification or indicate any issues with processing the request.

path Parameters
widgetId
required
string

The ID of a specific widget.

chatId
required
string

The ID of a specific chat session within the widget.

Request Body schema: application/json
required
property name*
additional property
any

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string"
}

Index Zendesk Articles

This endpoint indexes articles from Zendesk by processing the article data provided in the request. The request body should include details about the Zendesk articles to be indexed, such as article IDs or other identifying information. The system will fetch and index the content of these articles to make them searchable. The response will confirm the successful indexing of the articles or provide error details if the request fails.

Authorizations:
HTTPBearer
path Parameters
widgetId
required
string

The ID to associate the vector store with a specific widget.

Request Body schema: application/json
required
url
required
Array of strings (Url)
email
string (Email)
token
string (Zendesk Token)

Responses

Request samples

Content type
application/json
{
  • "url": [
    ],
  • "email": "string",
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "_shards": {
    },
  • "_total": 0,
  • "data": [
    ]
}

Auralis Core Vector Flow

Create a New Vector Store

This endpoint creates a new vector store entry in the vector database. The request body should include the necessary data to define the new vector store, such as the vectors and metadata. The response will contain information about the newly created vector store entry, including any relevant identifiers and status details.

Authorizations:
HTTPBearer
path Parameters
widgetId
required
string

The ID to associate the vector store with a specific widget.

Request Body schema: application/json
required
query
required
string
description
string
source
required
Array of strings
flagged
boolean
Default: false
flagged_comment
string
Default: ""
rating
integer
Default: 0

Responses

Request samples

Content type
application/json
{
  • "query": "string",
  • "description": "string",
  • "source": [
    ],
  • "flagged": false,
  • "flagged_comment": "",
  • "rating": 0
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string"
}

Update an Existing Vector Store

This endpoint updates an existing vector store entry in the vector database. The request body should contain the updated vector data and any other necessary information. The response will provide information about the updated vector store, including confirmation of the changes made.

Authorizations:
HTTPBearer
path Parameters
widgetId
required
string

The ID to associate the vector store with a specific widget.

queryId
required
string

The ID to associate the vector store with a specific widget.

Request Body schema: application/json
required
query
required
string
description
string
source
required
Array of strings
flagged
boolean
Default: false
flagged_comment
string
Default: ""
rating
integer
Default: 0

Responses

Request samples

Content type
application/json
{
  • "query": "string",
  • "description": "string",
  • "source": [
    ],
  • "flagged": false,
  • "flagged_comment": "",
  • "rating": 0
}

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string"
}

Delete a Vector Store Entry

This endpoint deletes a specific vector store entry from the vector database. The request body should include details required for identifying and removing the vector store entry. Optionally, a widget_id can be provided to specify the associated widget. The response will confirm the deletion of the vector store entry or provide error information if the request fails.

Authorizations:
HTTPBearer
path Parameters
widgetId
required
string

The ID to associate the vector store with a specific widget.

queryId
required
string

The ID to associate the vector store with a specific widget.

Responses

Response samples

Content type
application/json
{
  • "status": "string",
  • "message": "string"
}

Auralis Knowledge Center

Index Web URLs

This endpoint indexes web pages by processing the URLs and their content provided in the request. The request body should include details such as the URLs to be indexed and any associated metadata. The system will fetch the content from these URLs, analyze it, and store it in the index for further search and retrieval operations. The response will confirm the successful indexing of the specified websites or indicate any issues encountered during the process.

Authorizations:
HTTPBearer
path Parameters
widgetId
required
string

The ID to associate the vector store with a specific widget.

Request Body schema: application/json
required
urls
required
Array of strings (Url)

List of URLs to be indexed.

sourceType
required
string (Source Type)
Enum: "Web" "YoutubeVideo" "VimeoVideo" "Document" "Blog" "NewsArticle" "ForumPost" "Confluence" "Notion"

The type of source being indexed.

Responses

Request samples

Content type
application/json
{
  • "urls": [
    ],
  • "sourceType": "Web"
}

Response samples

Content type
application/json
{
  • "_shards": {
    },
  • "_total": 0,
  • "data": [
    ]
}

Index Custom Data

This endpoint indexes custom data for search and analysis. The request body should include data in a format suitable for indexing, allowing for flexibility in the structure of the input. The system will process this data, analyze its content, and integrate it into the index. The response will provide confirmation of successful indexing or details of any errors encountered during the process.

Authorizations:
HTTPBearer
path Parameters
widgetId
required
string

The ID to associate the vector store with a specific widget.

Request Body schema: application/json
required
custom_title
string (custom_title)

Title of the custom data to be indexed.

custom_description
string (custom_description)

Description of the custom data to be indexed.

custom_urls
Array of strings or null (custom_urls)

List of URLs to be optionally added.

Responses

Request samples

Content type
application/json
{
  • "custom_title": "string",
  • "custom_description": "string",
  • "custom_urls": [
    ]
}

Response samples

Content type
application/json
{
  • "_shards": {
    },
  • "_total": 0,
  • "data": [
    ]
}

Synchronize Web data

This endpoint synchronizes and indexes website data for analysis. The request body should include details required to fetch and index the website content. The system will process this data and integrate it into the index, providing a confirmation of successful synchronization or details of any errors encountered.

Authorizations:
HTTPBearer
path Parameters
docId
required
string

The ID of a specific document.

widgetId
required
string

The ID to associate the vector store with a specific widget.

Request Body schema: application/json
required
url
required
string (Url)
created_by
required
string (Created By)
required
Created Timestamp (integer) or Created Timestamp (number) (Created Timestamp)

Responses

Request samples

Content type
application/json
{
  • "url": "string",
  • "created_by": "string",
  • "created_timestamp": 0
}

Response samples

Content type
application/json
{
  • "_shards": {
    },
  • "_total": 0,
  • "data": [
    ]
}