Skip to content
API Reference
/
ai-analytics
/
ai_analytics_orgs_users_traces_list

ibl-data-manager (3.59.0-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_total_users_by_mentor_list

Request

Retrieve the total number of users interacting with mentors over time.

This endpoint returns data on the number of unique users who interacted with mentors each day or hour within a specified date range, with optional filtering by specific mentor. If no date range is provided, the last 30 days are used by default.

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

Returns: Response: Time series of unique user counts.

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

Query Parameters: start_date (str): Start date for filtering (YYYY-MM-DD) - defaults to 30 days ago. end_date (str): End date for filtering (YYYY-MM-DD) - defaults to today. aggregation (str): Time aggregation level (hourly, daily) - default: daily. mentor_id (str): Filter by mentor unique ID.

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
aggregationstring

Time aggregation level (hourly, daily)

Default "daily"
Enum"daily""hourly"
end_datestring

End date for filtering (YYYY-MM-DD)

group_bystringnon-empty
Default "day"
mentor_idstring

Filter by mentor unique ID

start_datestring

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}/total-users-by-mentor/?aggregation=daily&end_date=string&group_by=day&mentor_id=string&start_date=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/jsonArray [
periodstring(date-time)required
user_countintegerrequired
]
Response
application/json
[
  [
    { … },
    { … },
    { … }
  ]
]

ai_analytics_orgs_users_traces_list

Request

Viewset for retrieving and listing Langfuse traces.

This viewset provides read-only access to Langfuse traces data for platform admins. Traces represent high-level tracking of user interactions and AI responses.

Permissions:

  • Restricted to platform administrators only
Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
limitinteger

Number of results to return per page.

offsetinteger

The initial index from which to return the results.

orderingstring

Which field to use when ordering the results.

searchstring

A search term.

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/traces/?limit=0&offset=0&ordering=string&search=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
countintegerrequired
Example: 123
nextstring or null(uri)
Example: "http://api.example.org/accounts/?offset=400&limit=100"
previousstring or null(uri)
Example: "http://api.example.org/accounts/?offset=200&limit=100"
resultsArray of objects(Trace)required
results[].​idstringrequired
results[].​timestampstring(date-time)required
results[].​namestringrequired
results[].​user_idstring or null
results[].​metadataanyrequired
results[].​releasestring or null
results[].​versionstring or null
results[].​tagsArray of stringsrequired
results[].​inputstring or null
results[].​outputstring or null
results[].​session_idstring or null
results[].​created_atstring(date-time)read-onlyrequired
results[].​updated_atstring(date-time)
results[].​event_tsstring(date-time)required
results[].​is_deletedinteger[ 0 .. 255 ]required
Response
application/json
{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    { … }
  ]
}

ai_analytics_orgs_users_traces_retrieve

Request

Viewset for retrieving and listing Langfuse traces.

This viewset provides read-only access to Langfuse traces data for platform admins. Traces represent high-level tracking of user interactions and AI responses.

Permissions:

  • Restricted to platform administrators only
Security
PlatformApiKeyAuthentication
Path
idstringrequired
orgstringrequired
user_idstringrequired
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/traces/{id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
idstringrequired
timestampstring(date-time)required
namestringrequired
user_idstring or null
metadataanyrequired
releasestring or null
versionstring or null
tagsArray of stringsrequired
inputstring or null
outputstring or null
session_idstring or null
created_atstring(date-time)read-onlyrequired
updated_atstring(date-time)
event_tsstring(date-time)required
is_deletedinteger[ 0 .. 255 ]required
Response
application/json
{
  "id": "string",
  "timestamp": "2019-08-24T14:15:22Z",
  "name": "string",
  "user_id": "string",
  "metadata": null,
  "release": "string",
  "version": "string",
  "tags": [
    "string"
  ],
  "input": "string",
  "output": "string",
  "session_id": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "event_ts": "2019-08-24T14:15:22Z",
  "is_deleted": 255
}

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
Copyright © ibl.ai | support@iblai.zendesk.com