GETTING STARTED
SearchAssist Overview
SearchAssist Introduction
Onboarding SearchAssist
Build your first App
Glossary
Release Notes
What's new in SearchAssist
Previous Versions

CONCEPTS
Managing Sources
Introduction
Files
Web Pages
FAQs
Structured Data 
Connectors
Introduction to Connectors
Azure Storage Connector
Confluence Cloud Connector
Confluence Server Connector
Custom Connector
DotCMS Connector
Dropbox Connector
Google Drive Connector
Oracle Knowledge Connector
Salesforce Connector
ServiceNow Connector
SharePoint Connector
Zendesk Connector
RACL
Virtual Assistants
Managing Indices
Introduction
Index Fields
Traits
Workbench
Introduction to Workbench
Field Mapping
Entity Extraction
Traits Extraction
Keyword Extraction
Exclude Document
Semantic Meaning
Snippet Extraction
Custom LLM Prompts
Index Settings
Index Languages
Managing Chunks
Chunk Browser
Managing Relevance
Introduction
Weights
Highlighting
Presentable
Synonyms
Stop Words
Search Relevance
Spell Correction
Prefix Search
Custom Configurations
Personalizing Results
Introduction
Answer Snippets
Introduction
Extractive Model
Generative Model
Enabling Both Models
Simulation and Testing
Debugging
Best Practices and Points to Remember
Troubleshooting Answers
Answer Snippets Support Across Content Sources
Result Ranking
Facets
Business Rules
Introduction
Contextual Rules
NLP Rules
Engagement
Small Talk
Bot Actions
Designing Search Experience
Introduction
Search Interface
Result Templates
Testing
Preview and Test
Debug Tool
Running Experiments
Introduction
Experiments
Analyzing Search Performance
Overview
Dashboard
User Engagement
Search Insights
Result Insights
Answer Insights

ADMINISTRATION
General Settings
Credentials
Channels
Team
Collaboration
Integrations
OpenAI Integration
Azure OpenAI Integration
Custom Integration
Billing and Usage
Plan Details
Usage Logs
Order and Invoices
Smart Hibernation

SearchAssist APIs
API Introduction
API List

SearchAssist SDK

HOW TOs
Use Custom Fields to Filter Search Results and Answers
Add Custom Metadata to Ingested Content
Write Painless Scripts
Configure Business Rules for Generative Answers

Permission Entity APIs

Get Permission Entities

This API lists all the permission entities associated with a connector. 

Method GET
Endpoint <host_url>/searchassistapi/external/stream/<stream-id>/connector/<connector-id>/permission_entities
Content-Type application/json
Authorization auth: <JWT Token>
API Scope user_association

Query Parameters

Parameters Description Mandatory
Stream ID Provide your application ID here.  Yes
Connector ID Unique ID of the connector for which permission entities are requested. yes
Skip No of records to skip from the beginning of the response No
Limit Maximum number of records to return in the response No

Sample Response

[
  {
    "_id": "fpe-1e964f98-68cf-5b5e-802d-0f4c88577c52",
    "searchIndexId": "sidx-1a03bc64-a17c-59f7-ba81-6a9be27a08db",
    "entity": "fd8f94c3b58b8110f8779c9460b514ce",
    "userIds": [
      "searchAI@kore.com"
    ],
    "blocklist": [],
    "whitelist": [],
    "meta": {},
    "SHA": "eyJtb2RpZmllZE9uIjoiMjAyMi0wNC0yOCAyMTo1NDo1MSJ9",
    "createdOn": "2024-06-07T13:23:34.204Z",
    "modifiedOn": "2024-06-07T13:23:34.204Z"
  }
]

Get Permission Entity by ID

This API returns the details of the request permission entity. It lists the users associated with the permission entity. 

Method GET
Endpoint <host_url>/searchassistapi/external/stream/<stream-id>/connector/<connector-id>/permission_entities/<entity-id>
Content-Type application/json
Authorization auth: <JWT Token>
API Scope user_association

Query Parameters

Parameters Description Mandatory
Stream ID Provide your application ID here.  Yes
Entity Id Unique Id of the Permission Entity  Yes

Sample Response

{
  "_id": "fpe-1e964f98-68cf-5b5e-802d-0f4c88577c52",
  "searchIndexId": "sidx-1a03bc64-a17c-59f7-ba81-6a9be27a08db",
  "entity": "fd8f94c3b58b8110f8779c9460b514ce",
  "userIds": [
    "sample-user1@kore.com"
  ],
  "blocklist": [],
  "whitelist": [],
  "meta": {},
  "SHA": "eyJtb2RpZmllZE9uIjoiMjAyMi0wNC0yOCAyMTo1NDo1MSJ9",
  "createdOn": "2024-06-07T13:23:34.204Z",
  "modifiedOn": "2024-06-07T13:23:34.204Z"
}

Update Permission Entity by ID

This API is used to associate users to a Permission Entity. You can add new users to the entity using this API.

Method PUT
Endpoint <host_url>/searchassistapi/external/stream/<stream-id>/connector/<connector-id>/permission_entities/<entity-id>
Content-Type application/json
Authorization auth: <JWT Token>
API Scope user_association

Query Parameters

<tdUnique Id of the Permission Entity Yes

Parameters Description Mandatory
Stream ID Provide your application ID here.  Yes
Entity Id

Sample Request Body

To associate a user with a permission entity, use the following as the request body. 

{
  "userIds": [
    "john@kore.com"
  ]
}

Delete Users Permission Entity by ID

This API is used to remove a user already associated with the permission entity. 

Method DELETE
Endpoint <host_url>/searchassistapi/external/stream/<stream-id>/connector/<connector-id>/permission_entities/<entity-id>
Content-Type application/json
Authorization auth: <JWT Token>
API Scope user_association

Query Parameters

Parameters Description Mandatory
Stream ID Provide your application ID here.  Yes
Entity Id Unique Id of the Permission Entity  Yes

Sample Request Body

To delete a user from a permission entity, use the following as the request body. 

{
  "userIds": [
    "john@kore.com"
  ]
}

Permission Entity APIs

Get Permission Entities

This API lists all the permission entities associated with a connector. 

Method GET
Endpoint <host_url>/searchassistapi/external/stream/<stream-id>/connector/<connector-id>/permission_entities
Content-Type application/json
Authorization auth: <JWT Token>
API Scope user_association

Query Parameters

Parameters Description Mandatory
Stream ID Provide your application ID here.  Yes
Connector ID Unique ID of the connector for which permission entities are requested. yes
Skip No of records to skip from the beginning of the response No
Limit Maximum number of records to return in the response No

Sample Response

[
  {
    "_id": "fpe-1e964f98-68cf-5b5e-802d-0f4c88577c52",
    "searchIndexId": "sidx-1a03bc64-a17c-59f7-ba81-6a9be27a08db",
    "entity": "fd8f94c3b58b8110f8779c9460b514ce",
    "userIds": [
      "searchAI@kore.com"
    ],
    "blocklist": [],
    "whitelist": [],
    "meta": {},
    "SHA": "eyJtb2RpZmllZE9uIjoiMjAyMi0wNC0yOCAyMTo1NDo1MSJ9",
    "createdOn": "2024-06-07T13:23:34.204Z",
    "modifiedOn": "2024-06-07T13:23:34.204Z"
  }
]

Get Permission Entity by ID

This API returns the details of the request permission entity. It lists the users associated with the permission entity. 

Method GET
Endpoint <host_url>/searchassistapi/external/stream/<stream-id>/connector/<connector-id>/permission_entities/<entity-id>
Content-Type application/json
Authorization auth: <JWT Token>
API Scope user_association

Query Parameters

Parameters Description Mandatory
Stream ID Provide your application ID here.  Yes
Entity Id Unique Id of the Permission Entity  Yes

Sample Response

{
  "_id": "fpe-1e964f98-68cf-5b5e-802d-0f4c88577c52",
  "searchIndexId": "sidx-1a03bc64-a17c-59f7-ba81-6a9be27a08db",
  "entity": "fd8f94c3b58b8110f8779c9460b514ce",
  "userIds": [
    "sample-user1@kore.com"
  ],
  "blocklist": [],
  "whitelist": [],
  "meta": {},
  "SHA": "eyJtb2RpZmllZE9uIjoiMjAyMi0wNC0yOCAyMTo1NDo1MSJ9",
  "createdOn": "2024-06-07T13:23:34.204Z",
  "modifiedOn": "2024-06-07T13:23:34.204Z"
}

Update Permission Entity by ID

This API is used to associate users to a Permission Entity. You can add new users to the entity using this API.

Method PUT
Endpoint <host_url>/searchassistapi/external/stream/<stream-id>/connector/<connector-id>/permission_entities/<entity-id>
Content-Type application/json
Authorization auth: <JWT Token>
API Scope user_association

Query Parameters

<tdUnique Id of the Permission Entity Yes

Parameters Description Mandatory
Stream ID Provide your application ID here.  Yes
Entity Id

Sample Request Body

To associate a user with a permission entity, use the following as the request body. 

{
  "userIds": [
    "john@kore.com"
  ]
}

Delete Users Permission Entity by ID

This API is used to remove a user already associated with the permission entity. 

Method DELETE
Endpoint <host_url>/searchassistapi/external/stream/<stream-id>/connector/<connector-id>/permission_entities/<entity-id>
Content-Type application/json
Authorization auth: <JWT Token>
API Scope user_association

Query Parameters

Parameters Description Mandatory
Stream ID Provide your application ID here.  Yes
Entity Id Unique Id of the Permission Entity  Yes

Sample Request Body

To delete a user from a permission entity, use the following as the request body. 

{
  "userIds": [
    "john@kore.com"
  ]
}