Skip to content
API Reference/
/
Create memory

ibl-data-manager (4.84.1-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-bot

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai_mentor_orgs_users_memories_list

Request

Retrieve a list of memories based on filter conditions.

Returns: Response: A paginated list of memories. Put your queries using the parameters in the query parameters. For example, to search a mentor's regular mode memory, use the following url:

https://base.manager.iblai.app/api/ai-mentor/orgs/your-org/users/your-user/memories/?mentor=f81fc856-fd8f-4e6b-9d3b-72aa68279c40&mode=regular

Raises: NotFound: If the query is invalid.

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
categorystring

a string of category to filter memories

end_datestring

ISO date for end date (optional)

mentorstring

the mentor unique id which the memory is linked to

modestring

mode which the memory applies to. can be guided, regular or all

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

platformstring

the platform which the memory is linked to

sessionstring

the session id which the memory is linked to

start_datestring

ISO date for start date (optional)

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/memories/?category=string&end_date=string&mentor=string&mode=string&page=0&page_size=0&platform=string&session=string&start_date=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(UserMemory)required
results[].​modestringread-onlyrequired
results[].​namestring
results[].​emailstring or nullread-onlyrequired
results[].​unique_idstring(uuid)
results[].​usernamestring or nullread-onlyrequired
results[].​platformstring or nullread-onlyrequired
results[].​mentorstring or nullread-onlyrequired
results[].​session_idstring or nullread-onlyrequired
results[].​catalog_item_typestring or nullread-onlyrequired
results[].​catalog_item_idstring or nullread-onlyrequired
results[].​entriesArray of objects(UserMemoryEntry)required
results[].​entries[].​unique_idstring(uuid)
results[].​entries[].​keystringrequired
results[].​entries[].​valuestring or null
results[].​entries[].​inserted_atstringread-onlyrequired
results[].​entries[].​updated_atstringread-onlyrequired
results[].​entries[].​expires_atstring or nullread-onlyrequired
results[].​entries[].​categorystring or nullread-onlyrequired
results[].​inserted_atstringread-onlyrequired
results[].​updated_atstringread-onlyrequired
results[].​is_auto_generatedboolean
results[].​categorystring or null
Response
application/json
{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    { … }
  ]
}

Create memory

Request

Create memory using the request data

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

Body
required
modestring
Default "all"
namestring or null
platformstring or null
mentor_unique_idstring or null
session_idstring or null
catalog_item_typestring or null
catalog_item_idstring or null
entriesArray of objects(UserMemoryEntryRequest)required
entries[].​keystringrequired
entries[].​valuestringrequired
entries[].​expires_atstring or null
categorystring or null
curl -i -X POST \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/memories/?page=0&page_size=0' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "all",
    "name": "string",
    "platform": "string",
    "mentor_unique_id": "string",
    "session_id": "string",
    "catalog_item_type": "string",
    "catalog_item_id": "string",
    "entries": [
      {
        "key": "string",
        "value": "string",
        "expires_at": "string"
      }
    ],
    "category": "string"
  }'

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(UserMemory)required
results[].​modestringread-onlyrequired
results[].​namestring
results[].​emailstring or nullread-onlyrequired
results[].​unique_idstring(uuid)
results[].​usernamestring or nullread-onlyrequired
results[].​platformstring or nullread-onlyrequired
results[].​mentorstring or nullread-onlyrequired
results[].​session_idstring or nullread-onlyrequired
results[].​catalog_item_typestring or nullread-onlyrequired
results[].​catalog_item_idstring or nullread-onlyrequired
results[].​entriesArray of objects(UserMemoryEntry)required
results[].​entries[].​unique_idstring(uuid)
results[].​entries[].​keystringrequired
results[].​entries[].​valuestring or null
results[].​entries[].​inserted_atstringread-onlyrequired
results[].​entries[].​updated_atstringread-onlyrequired
results[].​entries[].​expires_atstring or nullread-onlyrequired
results[].​entries[].​categorystring or nullread-onlyrequired
results[].​inserted_atstringread-onlyrequired
results[].​updated_atstringread-onlyrequired
results[].​is_auto_generatedboolean
results[].​categorystring or null
Response
application/json
{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    { … }
  ]
}

ai_mentor_orgs_users_memory_categories_retrieve

Request

Use the this endpoint to get all memory categories:

GET /api/ai-mentor/orgs/main/users/your-user/memory-categories/

Sample response

{"categories": ["lessons_learned", "knowledge_gaps", "help_requests", "personal_information"]}
Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/memory-categories/' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

No response body

ai-prompt

Operations

analytics

Operations

career

Operations

catalog

Operations

core

Operations

credentials

Operations

custom-domains

Operations

features

Operations

media

Operations

notifications

Operations

scim

Operations

commerce

Operations

recommendations

Operations

reports

Operations

skills

Operations
Copyright © ibl.ai | support@iblai.zendesk.com