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

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai_mentor_orgs_users_custom_instruction_update

Request

Update an existing custom instruction for a user.

Args: request: The HTTP request containing the updated custom instruction data. org: The organization/tenant identifier. user_id: The ID of the user to update custom instructions for.

Returns: Response: The updated custom instruction.

Raises: BadRequest: If the provided data is invalid. NotFound: If no custom instruction exists for the user.

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Body
about_userstring or null
mentor_tonestring or null
professionstring<= 100 characters

Position or work. eg: Engineer, student etc.

desired_mentor_traitsstring

Comma separated list of expected traits for mentor.

curl -i -X PUT \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/custom-instruction/' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "content": "Always explain concepts in simple terms with examples and analogies."
  }'

Responses

Bodyapplication/json
idintegerread-onlyrequired
about_userstring or null
mentor_tonestring or null
professionstring<= 100 characters

Position or work. eg: Engineer, student etc.

desired_mentor_traitsstring

Comma separated list of expected traits for mentor.

Response
application/json
{ "id": 1, "username": "johndoe", "platform_key": "main", "content": "Always explain concepts in simple terms with examples and analogies.", "created_at": "2023-01-01T12:00:00Z", "updated_at": "2023-01-02T14:30:00Z" }

ai_mentor_orgs_users_downloads_tasks_retrieve

Request

Retrieves the chat history for a user if the export task is ready.

This Endpoint to download user chathistory.

Accessible to tenant admins and students.

Returns:

200: When task is not ready.

200: chat history object

400: When data is not valid.

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
task_idstring(uuid)required
user_idstringrequired
Query
to_csvboolean

Choose download in csv or not

Default false
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/downloads/tasks/{task_id}/?to_csv=false' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
typestringrequired
contentstringrequired
timestampstring(date-time)required
Response
application/json
{ "state": "task_not_ready" }

ai_mentor_orgs_users_edx_memory_list

Request

Endpoints to fetch and delete Edx stored Memory information stored for a user and a corresponding edx course they have interracted with. This information is passed to the corresponding mentor so the mentor has context information about the course and unit that the user last interracted with.

There can be only one UserEdxMemory instance per student and course_id.

Url Args: org (str): The organization's platform key. user_id (str): The username identifier of the individual.

Returns:

200: A paginated list of UserEdxMemory objects

Examples:

  • List all memories GET: /api/ai-mentor/orgs/main/users/johndoe/edx-memory/

    Request: None Response: { "count": 0, "next": null, "previous": null, "results": [{ "student": 1, "course_id": "course-v1:main+CARBON+2024_Fall", "data": {}, "date_created": "2024-06-25T15:30:26.257140", "last_modified": "2024-06-25T15:30:26.257140" }] }

  • Get a single UserEdxMemory object GET: /api/ai-mentor/orgs/main/users/johndoe/edx-memory/1/

    Request: None Response: { "student": 1, "course_id": "course-v1:main+CARBON+2024_Fall", "data": {}, "date_created": "2024-06-25T15:30:26.257140", "last_modified": "2024-06-25T15:30:26.257140" }

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
course_idstring
orderingstring

Which field to use when ordering the results.

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

studentinteger[ 0 .. 2147483647 ]

edX user ID

usernamestring
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/edx-memory/?course_id=string&ordering=string&page=0&page_size=0&student=2147483647&username=string' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
countintegerrequired
Example: 123
nextstring or null(uri)
Example: "http://api.example.org/accounts/?page=4"
previousstring or null(uri)
Example: "http://api.example.org/accounts/?page=2"
resultsArray of objects(UserEdxMemory)required
results[].​idintegerread-onlyrequired
results[].​usernamestringread-onlyrequired
results[].​studentinteger[ 0 .. 2147483647 ]required

edX user ID

results[].​course_idstring<= 200 charactersrequired
results[].​dataany

The course data to be stored. This includes the current page and the blocks that have been visited.

results[].​date_createdstring(date-time)read-onlyrequired
results[].​last_modifiedstring(date-time)read-onlyrequired
Response
application/json
{ "count": 123, "next": "http://api.example.org/accounts/?page=4", "previous": "http://api.example.org/accounts/?page=2", "results": [ {} ] }

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