Skip to content

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

Request

API view for managing disclaimer agreements.

This viewset provides Create Read and Delete operations for disclaimer agreements with different access levels:

Platform Admins:

  • Can view all disclaimer agreements for their platform
  • Have full access to create (for themselves) and delete agreements for themselves and other users.
  • Results are paginated and can be filtered

Students:

  • Can only view their own disclaimer agreements
  • Limited to agreements where they are the user
  • Results are paginated and can be filtered

List endpoint returns paginated results with disclaimer agreement objects:

{
    "count": int,
    "next": str,
    "previous": str,
    "results": [
        {
            "id": int,
            "user": str,
            "disclaimer": int,
            "agreed_at": datetime,

        },
        ...
    ]
}

Detail endpoints return a single disclaimer agreement object with the same structure

Security
PlatformApiKeyAuthentication
Path
idintegerrequired

A unique integer value identifying this disclaimer agreement.

orgstringrequired
user_idstringrequired
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/disclaimer-agreements/{id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
idintegerread-onlyrequired
userinteger[ 0 .. 2147483647 ]read-onlyrequired

edX user ID

disclaimerintegerrequired
agreed_atstring(date-time)read-onlyrequired
platform_keystringread-onlyrequired
user_idstringread-onlyrequired
Response
application/json
{ "id": 0, "user": 2147483647, "disclaimer": 0, "agreed_at": "2019-08-24T14:15:22Z", "platform_key": "string", "user_id": "string" }

ai_mentor_orgs_users_disclaimer_agreements_destroy

Request

API view for managing disclaimer agreements.

This viewset provides Create Read and Delete operations for disclaimer agreements with different access levels:

Platform Admins:

  • Can view all disclaimer agreements for their platform
  • Have full access to create (for themselves) and delete agreements for themselves and other users.
  • Results are paginated and can be filtered

Students:

  • Can only view their own disclaimer agreements
  • Limited to agreements where they are the user
  • Results are paginated and can be filtered

List endpoint returns paginated results with disclaimer agreement objects:

{
    "count": int,
    "next": str,
    "previous": str,
    "results": [
        {
            "id": int,
            "user": str,
            "disclaimer": int,
            "agreed_at": datetime,

        },
        ...
    ]
}

Detail endpoints return a single disclaimer agreement object with the same structure

Security
PlatformApiKeyAuthentication
Path
idintegerrequired

A unique integer value identifying this disclaimer agreement.

orgstringrequired
user_idstringrequired
curl -i -X DELETE \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/disclaimer-agreements/{id}/' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

No response body

ai_mentor_orgs_users_disclaimers_list

Request

ViewSet for managing mentor disclaimers.

This viewset provides endpoints for creating and managing mentor disclaimers, which are statements or information that mentors need to share with students.

Permissions:

  • Platform administrators have full CRUD access
  • Students have read-only access
  • Unauthenticated users have no access

Endpoints:

  • GET /api/orgs/{org}/users/{user_id}/disclaimers/ - List all disclaimers
  • POST /api/orgs/{org}/users/{user_id}/disclaimers/ - Create a new disclaimer
  • GET /api/orgs/{org}/users/{user_id}/disclaimers/{id}/ - Retrieve a specific disclaimer
  • PUT/PATCH /api/orgs/{org}/users/{user_id}/disclaimers/{id}/ - Update a disclaimer
  • POST /api/orgs/{org}/users/{user_id}/disclaimers/{id}/add_mentor/ - Add mentor to disclaimer
  • POST /api/orgs/{org}/users/{user_id}/disclaimers/{id}/remove_mentor/ - Remove mentor from disclaimer

Query Parameters:

  • Supports filtering via DjangoFilterBackend
  • See DisclaimerFilterSet for available filters

Returns: List endpoint returns paginated results with disclaimer objects:

{
    "count": int,
    "next": str,
    "previous": str,
    "results": [
        {
            "id": int,
            "title": str,
            "content": str,
            "mentor": str,
            "platform": str,
            "created_at": datetime,
            "updated_at": datetime
        },
        ...
    ]
}

Detail endpoints return a single disclaimer object with the same structure

Security
PlatformApiKeyAuthentication
Path
orgstringrequired
user_idstringrequired
Query
activeboolean
mentor_idstring(uuid)
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.

scopestring
  • platform - Platform
  • mentor - Mentor
Enum"mentor""platform"
searchstring

A search term.

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/ai-mentor/orgs/{org}/users/{user_id}/disclaimers/?active=true&mentor_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&ordering=string&page=0&page_size=0&scope=mentor&search=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(Disclaimer)required
results[].​idintegerread-onlyrequired
results[].​scopestring(ScopeEnum)
  • platform - Platform
  • mentor - Mentor
Enum"platform""mentor"
results[].​platformintegerread-onlyrequired

Platform to which the disclaimer applies.

results[].​contentstringrequired
results[].​titlestring<= 120 characters
results[].​activeboolean
results[].​created_atstring(date-time)read-onlyrequired
results[].​updated_atstring(date-time)read-onlyrequired
results[].​has_agreedbooleanread-onlyrequired
results[].​platform_keystringread-onlyrequired
results[].​mentorsArray of strings(uuid)
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

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