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/

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

ai_mentor_orgs_users_sessionid_list

Request

Retrieve user sessions filtered by start date and end date.

Query Parameters: start_date (optional, ISO format): Start date for filtering sessions. end_date (optional, ISO format): End date for filtering sessions.

Returns:

  • 200: List of session IDs with insertion timestamps.
  • 400: Invalid request parameters.
Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
end_datestringnon-empty
start_datestringnon-empty
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/sessionid/?end_date=string&start_date=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/jsonArray [
idstringrequired
]
Response
application/json
[ [ {}, {} ] ]

ai_mentor_orgs_users_sessions_create

Request

Retrieve or create a chat session with a mentor.

Passing null as tools results in using all tools assigned to the mentor. To specify that no tools be used, pass an empty list.

Args: request: HTTP request containing mentor details. org: Organization key identifier. user_id (optional): Username for authentication (if required by the mentor).

Returns: Response: JSON object containing the session ID.

Raises: Http404: If the mentor is not found. ValidationError: If the username is invalid. ValidationError: If one or more tool slugs are invalid.

Path
orgstringrequired
user_idstringrequired
Bodyrequired
mentorstringrequired

Name of mentor

toolsArray of strings

List of tools slugs to use. Passing null will use all tools assigned to the mentor. For no tools, pass an empty list.

curl -i -X POST \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/sessions/' \
  -H 'Content-Type: application/json' \
  -d '{
    "mentor": "ai-mentor"
  }'

Responses

Bodyapplication/json
session_idstring(uuid)required
toolsArray of objects(ToolResponse)required
tools[].​idintegerread-onlyrequired
tools[].​namestring<= 500 charactersrequired
tools[].​display_namestring<= 255 characters
tools[].​slugstring<= 50 characters^[-a-zA-Z0-9_]+$
tools[].​descriptionstring or null
tools[].​metadataany or null
tools[].​allow_retriever_mentorsboolean
tools[].​allow_openai_agentboolean
tools[].​allow_google_agentboolean
Response
application/json
{ "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "tools": [ {} ] }

Request

Fetches chat messages for a specific session.

Path
orgstringrequired
session_idstring(uuid)required
user_idstringrequired
Query
shareboolean
Default false
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/sessions/{session_id}/?share=false'

Responses

Bodyapplication/json
countintegerrequired
titlestringrequired
proactive_promptstringrequired
mentor_unique_idstringrequired
platform_keystringrequired
previousstringrequired
nextstringrequired
resultsArray of objectsrequired
Response
application/json
{ "count": 0, "title": "string", "proactive_prompt": "string", "mentor_unique_id": "string", "platform_key": "string", "previous": "string", "next": "string", "results": [ null ] }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations