Skip to content

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

API for iblai

Download OpenAPI description
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_transcripts_list

Request

Retrieve message data from conversations.

This endpoint returns data on messages within conversations, with options for filtering by date range, topics, and mentor.

Args: request: The HTTP request containing filter query parameters. org: Organization key identifier. user_id: User identifier (not used in the implementation).

Returns: Response: A list of conversation message data.

Raises: NotFound: If the specified organization does not exist. ValidationError: If the provided query parameters are invalid.

Query Parameters: start_date (str): Start date for filtering (YYYY-MM-DD). end_date (str): End date for filtering (YYYY-MM-DD). topics (str): Comma-separated list of topics to filter by. mentor (str): Filter by mentor unique ID.

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
end_datestring(date)
mentorstringnon-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}/transcripts/?end_date=2019-08-24&mentor=string&start_date=2019-08-24&topics=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/jsonArray [
first_messagestringread-onlyrequired
topicsArray of objects(TopicModel)required
topics[].​namestring<= 255 charactersrequired
idstring(uuid)required
user_idstringrequired
message_countintegerread-onlyrequired
modelstringrequired
inserted_atstring(date-time)required
user_sentimentstringread-onlyrequired
]
Response
application/json
[ [ {}, {} ] ]

ai_analytics_orgs_users_usage_summary_list

Request

Retrieve daily user engagement metrics with mentors.

This endpoint returns data on the number of unique users who interact with mentors each day within a specified date range.

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

Returns: Response: Daily time series of unique user counts.

Raises: NotFound: If the specified organization does not exist. BadRequest: If the provided parameters are invalid.

Query Parameters: start_date (str): Start date for filtering (YYYY-MM-DD) - required. end_date (str): End date for filtering (YYYY-MM-DD) - required.

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
end_datestringrequired

End date for filtering (YYYY-MM-DD)

group_bystringnon-empty
Default "day"
start_datestringrequired

Start date for filtering (YYYY-MM-DD)

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/usage-summary/?end_date=string&group_by=day&start_date=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/jsonArray [
datestring(date)required
user_countintegerrequired
]
Response
application/json
[ [ {}, {}, {} ] ]

ai_analytics_orgs_users_user_cohorts_over_time_retrieve

Request

Retrieve user cohort trends over time.

This endpoint returns data on the distribution of new versus veteran users over time, with options for different time aggregations and filtering by mentor. New users are those who registered within the specified date range, while veteran users are those who registered before the date range but were active during it.

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

Returns: Response: Time series of new and veteran user counts.

Raises: NotFound: If the specified organization does not exist. BadRequest: If the provided parameters are invalid.

Query Parameters: start_date (str): Start date for filtering (YYYY-MM-DD) - required. end_date (str): End date for filtering (YYYY-MM-DD) - required. aggregation (str): Time aggregation level (hourly, daily, weekly) - default: daily. mentor_id (str): Filter by mentor unique ID.

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
aggregationstring

Time aggregation level (hourly, daily, weekly)

Default "daily"
Enum"daily""hourly""weekly"
end_datestringrequired

End date for filtering (YYYY-MM-DD)

mentor_idstring

Filter by mentor unique ID

start_datestringrequired

Start date for filtering (YYYY-MM-DD)

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/user-cohorts-over-time/?aggregation=daily&end_date=string&mentor_id=string&start_date=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
periodsArray of strings(date-time)required
new_usersArray of integersrequired
veteran_usersArray of integersrequired
Response
application/json
{ "periods": [ "2023-06-01T00:00:00Z", "2023-06-02T00:00:00Z", "2023-06-03T00:00:00Z" ], "new_users": [ 8, 12, 5 ], "veteran_users": [ 42, 38, 45 ] }

ai-bot

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai-prompt

Operations

career

Operations

catalog

Operations

core

Operations

credentials

Operations

features

Operations

media

Operations

notifications

Operations

scim

Operations

commerce

Operations

recommendations

Operations

reports

Operations

skills

Operations