Skip to content
API Reference/
/
ai_analytics_orgs_users_c...

ibl-data-manager (4.84.1-ai-plus)

API for iblai

Download OpenAPI description
ibl.json
ibl.yaml
Languages
Servers
Mock server
https://docs.ibl.ai/_mock/apis/ibl/
https://base.manager.iblai.app/

ai-account

Operations

ai-analytics

Operations

ai_analytics_orgs_users_chat_history_filter_retrieve

Request

Retrieve filter options for chat message history.

This endpoint returns data on available filter options for the chat message history endpoint, including topics, date ranges (weekly or monthly), sentiments, and users who have chat history.

Args: request: The HTTP request containing query parameters. org: Organization key identifier.

Returns: Response: Available filter options for chat message history.

Raises: NotFound: If the specified organization does not exist.

Query Parameters: monthly_range (bool): Whether to return monthly or weekly date ranges. mentor_id (str): Filter users by those who have chatted with a specific mentor.

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
end_datestring(date)
mentor_idstring(uuid)
monthly_rangeboolean
Default false
start_datestring(date)
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/chat-history-filter/?end_date=2019-08-24&mentor_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&monthly_range=false&start_date=2019-08-24' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
topicsArray of objects(TopicModel)required
topics[].​namestring<= 255 charactersrequired
date_rangesArray of objects(DateRange)
sentimentArray of strings
usersArray of objects(ChatHistoryFilterUser)required
users[].​usernamestringrequired
users[].​emailstring(email)required
users[].​lti_emailstring(email)read-onlyrequired
Response
application/json
{
  "topics": [
    { … },
    { … }
  ],
  "date_ranges": [
    { … },
    { … }
  ],
  "setiment": [
    "positive",
    "negative",
    "neutral"
  ],
  "users": [
    { … },
    { … }
  ]
}

ai_analytics_orgs_users_chat_history_retrieve

Request

API viewset for retrieving and filtering chat message history.

This viewset provides endpoints for retrieving chat message history within an organization, with extensive filtering options by date range, user, topic, mentor, and sentiment.

Permissions: - Restricted to platform administrators only

Security
PlatformApiKeyAuthentication
Path
idstringrequired
orgstringrequired
user_idstringrequired
Query
end_datestring(date)
filter_user_idstringnon-empty
mentorstring(uuid)
sentimentstringnon-empty
start_datestring(date)
topicsstringnon-empty
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/chat-history/{id}/?end_date=2019-08-24&filter_user_id=string&mentor=497f6eca-6276-4993-bfeb-53cbbbba6f08&sentiment=string&start_date=2019-08-24&topics=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
idstring(uuid)read-onlyrequired
messagesstringread-onlyrequired
topicsArray of objects(TopicModel)required
topics[].​namestring<= 255 charactersrequired
sentimentstringread-onlyrequired
mentorstring(uuid)required
studentstringread-onlyrequired
emailstringread-onlyrequired
modelstringrequired
ratingintegerread-onlyrequired
platformstringrequired
lti_emailstringread-onlyrequired

Email claim from LTI1.3 JWT if an LTI user and available

lti_usernamestringread-onlyrequired

Username claim from LTI1.3 JWT if an LTI user and available

inserted_atstring(date-time)read-onlyrequired
has_documentboolean
memory_trackedboolean
enable_artifactsboolean
llm_namestring or null<= 255 characters
llm_providerstring or null<= 255 characters
metadataany or null
is_conversationboolean

True if the session has both user and AI messages

toolsArray of integers
Response
application/json
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "messages": "string",
  "topics": [
    { … }
  ],
  "sentiment": "string",
  "mentor": "ecbf8dc6-e97d-4602-939f-cda86082faa0",
  "student": "string",
  "email": "string",
  "model": "string",
  "rating": 0,
  "platform": "string",
  "lti_email": "string",
  "lti_username": "string",
  "inserted_at": "2019-08-24T14:15:22Z",
  "has_document": true,
  "memory_tracked": true,
  "enable_artifacts": true,
  "llm_name": "string",
  "llm_provider": "string",
  "metadata": null,
  "is_conversation": true,
  "tools": [
    0
  ]
}

ai_analytics_orgs_users_chat_history_update

Request

API viewset for retrieving and filtering chat message history.

This viewset provides endpoints for retrieving chat message history within an organization, with extensive filtering options by date range, user, topic, mentor, and sentiment.

Permissions: - Restricted to platform administrators only

Security
PlatformApiKeyAuthentication
Path
idstringrequired
orgstringrequired
user_idstringrequired
Query
end_datestring(date)
filter_user_idstringnon-empty
mentorstring(uuid)
sentimentstringnon-empty
start_datestring(date)
topicsstringnon-empty
Body
required
topicsArray of objects(TopicModel)required
topics[].​namestring<= 255 charactersrequired
mentorstring(uuid)required
modelstringrequired
platformstringrequired
has_documentboolean
memory_trackedboolean
enable_artifactsboolean
llm_namestring or null<= 255 characters
llm_providerstring or null<= 255 characters
metadataany or null
is_conversationboolean

True if the session has both user and AI messages

toolsArray of integers
curl -i -X PUT \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/chat-history/{id}/?end_date=2019-08-24&filter_user_id=string&mentor=497f6eca-6276-4993-bfeb-53cbbbba6f08&sentiment=string&start_date=2019-08-24&topics=string' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "topics": [
      {
        "name": "string"
      }
    ],
    "mentor": "ecbf8dc6-e97d-4602-939f-cda86082faa0",
    "model": "string",
    "platform": "string",
    "has_document": true,
    "memory_tracked": true,
    "enable_artifacts": true,
    "llm_name": "string",
    "llm_provider": "string",
    "metadata": null,
    "is_conversation": true,
    "tools": [
      0
    ]
  }'

Responses

Bodyapplication/json
idstring(uuid)read-onlyrequired
messagesstringread-onlyrequired
topicsArray of objects(TopicModel)required
topics[].​namestring<= 255 charactersrequired
sentimentstringread-onlyrequired
mentorstring(uuid)required
studentstringread-onlyrequired
emailstringread-onlyrequired
modelstringrequired
ratingintegerread-onlyrequired
platformstringrequired
lti_emailstringread-onlyrequired

Email claim from LTI1.3 JWT if an LTI user and available

lti_usernamestringread-onlyrequired

Username claim from LTI1.3 JWT if an LTI user and available

inserted_atstring(date-time)read-onlyrequired
has_documentboolean
memory_trackedboolean
enable_artifactsboolean
llm_namestring or null<= 255 characters
llm_providerstring or null<= 255 characters
metadataany or null
is_conversationboolean

True if the session has both user and AI messages

toolsArray of integers
Response
application/json
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "messages": "string",
  "topics": [
    { … }
  ],
  "sentiment": "string",
  "mentor": "ecbf8dc6-e97d-4602-939f-cda86082faa0",
  "student": "string",
  "email": "string",
  "model": "string",
  "rating": 0,
  "platform": "string",
  "lti_email": "string",
  "lti_username": "string",
  "inserted_at": "2019-08-24T14:15:22Z",
  "has_document": true,
  "memory_tracked": true,
  "enable_artifacts": true,
  "llm_name": "string",
  "llm_provider": "string",
  "metadata": null,
  "is_conversation": true,
  "tools": [
    0
  ]
}

ai-bot

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai-prompt

Operations

analytics

Operations

career

Operations

catalog

Operations

core

Operations

credentials

Operations

custom-domains

Operations

features

Operations

media

Operations

notifications

Operations

scim

Operations

commerce

Operations

recommendations

Operations

reports

Operations

skills

Operations
Copyright © ibl.ai | support@iblai.zendesk.com