Skip to content
API Reference
/
ai-analytics
/
ai_analytics_orgs_users_traces_retrieve

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_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_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-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