Skip to content
API Reference
/
catalog
/
catalog_suggestions_pathway_manage_group_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-bot

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai-prompt

Operations

career

Operations

catalog

Operations

catalog_suggestions_pathway_manage_bulk_create

Request

API View for bulk creation of pathway suggestions.

This endpoint allows administrators to create multiple pathway suggestions at once.

Methods: POST: Create multiple pathway suggestions in a single request

Request Body: A JSON object containing:

  • platform_key (str, required): The platform for the suggestions
  • suggestion_data (list, required): List of suggestion objects, each containing:
    • pathway_id (str, required): The pathway ID to suggest
    • user_id (str/int, required): The user to suggest the pathway to
    • accepted (bool, optional): Whether the suggestion is accepted
    • visible (bool, optional): Whether the suggestion is visible
    • metadata (dict, optional): Additional suggestion metadata

Returns: POST: A JSON response containing the operation results: { "successes": 15, "error_codes": [] }

Error Responses: 400 Bad Request: If required parameters are missing or invalid 401 Unauthorized: If the user is not authenticated 403 Forbidden: If the user does not have permission to manage suggestions 500 Internal Server Error: If an unexpected error occurs during bulk creation

Access Control:

  • Requires IsDMAdmin, IsPlatformAdmin, or IsDepartmentModeAdminInPlatform permission
  • Platform admins can create suggestions for their platform
  • Department admins can create suggestions for their departments
  • DM admins can create suggestions for any platform
Security
PlatformApiKeyAuthentication
Body
required
platform_keystringrequired

The platform for the suggestions

platform_orgstring

The organization identifier for the platform

suggestion_dataArray of objectsrequired

List of suggestion data objects, each containing pathway_id, user_id, etc.

suggestion_data[].​property name*anyadditional property
department_modeboolean

Flag to ensure department admins can call the API

Default false
curl -i -X POST \
  https://docs.ibl.ai/_mock/apis/ibl/api/catalog/suggestions/pathway/manage/bulk/ \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "platform_key": "string",
    "platform_org": "string",
    "suggestion_data": [
      {
        "property1": null,
        "property2": null
      }
    ],
    "department_mode": false
  }'

Responses

Bodyapplication/json
successesintegerrequired

Number of successfully created suggestions

error_codesArray of stringsrequired

List of error codes for failed suggestions

Response
application/json
{
  "successes": 0,
  "error_codes": [
    "string"
  ]
}

catalog_suggestions_pathway_manage_group_retrieve

Request

API View for managing pathway group suggestions.

This endpoint allows administrators to view, create, and delete pathway suggestions for groups of users within a platform.

Query Parameters (GET): platform_key (str, required): The platform to retrieve group suggestions for platform_org (str, optional): The organization identifier for the platform query (str, optional): Search term to filter group suggestions sort (str, optional): Field to sort results by (default: 'id') department_mode (bool, optional): Filter suggestions by department admin access page (int, optional): Page number for pagination page_size (int, optional): Number of items per page

Methods: GET: Retrieve a paginated list of pathway group suggestions for a platform POST: Create or update a pathway group suggestion DELETE: Remove a pathway group suggestion

Request Body (POST): A JSON object containing:

  • platform_key (str, required): The platform for the group suggestion
  • pathway_id (str, required): The pathway ID to suggest
  • group_id (str/int, required): The group to suggest the pathway to
  • accepted (bool, optional): Whether the suggestion is accepted
  • visible (bool, optional): Whether the suggestion is visible
  • metadata (dict, optional): Additional suggestion metadata

Query Parameters (DELETE): suggestion_id (int, required): The ID of the group suggestion to delete

Returns: GET: A paginated JSON response containing pathway group suggestions: { "count": 5, "next": "https://example.com/api/catalog/suggestions/pathway/group/?page=2", "previous": null, "results": [ { "id": 123, "group_id": 789, "group_name": "Engineering Team", "platform_key": "platform1", "accepted": false, "visible": true, "created": "2023-06-15T14:30:00Z", "modified": "2023-06-15T14:30:00Z", "metadata": {}, "pathway_id": "pathway-v1:org+pathway+run", "pathway_uuid": "12345678-1234-5678-1234-567812345678", "pathway_name": "Data Science Pathway", "pathway_platform_key": "platform1", "user_count": 25 }, ... ] }

POST: A JSON response containing the created/updated group suggestion: { "id": 123, "group_id": 789, "group_name": "Engineering Team", "platform_key": "platform1", "accepted": false, "visible": true, "created": "2023-06-15T14:30:00Z", "modified": "2023-06-15T14:30:00Z", "metadata": {}, "pathway_id": "pathway-v1:org+pathway+run", "pathway_uuid": "12345678-1234-5678-1234-567812345678", "pathway_name": "Data Science Pathway", "pathway_platform_key": "platform1", "user_count": 25 }

DELETE: A success response with status 200

Error Responses: 400 Bad Request: If required parameters are missing or invalid, or if group suggestion operations fail 401 Unauthorized: If the user is not authenticated 403 Forbidden: If the user does not have permission to manage group suggestions 500 Internal Server Error: If an unexpected error occurs

Access Control:

  • Requires IsDMAdmin, IsPlatformAdmin, or IsDepartmentModeAdminInPlatform permission
  • Platform admins can manage group suggestions for their platform
  • Department admins can manage group suggestions for their departments
  • DM admins can manage all group suggestions
Security
PlatformApiKeyAuthentication
Query
department_modeboolean

Filter suggestions by department admin access

pageinteger

Page number for pagination

page_sizeinteger

Number of items per page

platform_keystringnon-emptyrequired

The platform to retrieve group suggestions for

platform_orgstringnon-empty

The organization identifier for the platform

querystringnon-empty

Search term to filter group suggestions

sortstringnon-empty

Field to sort results by

Default "id"
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/catalog/suggestions/pathway/manage/group/?department_mode=true&page=0&page_size=0&platform_key=string&platform_org=string&query=string&sort=id' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
countintegerrequired

Total number of results

next_pagestring or null(uri)required

URL for next page of results

previous_pagestring or null(uri)required

URL for previous page of results

resultsArray of objects(PathwayGroupSuggestionDetail)required

List of pathway group suggestions

results[].​idintegerrequired

The unique identifier for the group suggestion

results[].​group_idintegerrequired

The ID of the group receiving the suggestion

results[].​group_namestringrequired

The name of the group receiving the suggestion

results[].​platform_keystringrequired

The platform key associated with the suggestion

results[].​acceptedboolean

Whether the suggestion has been accepted

results[].​visiblebooleanrequired

Whether the suggestion is visible

results[].​createdstring(date-time)required

When the suggestion was created

results[].​modifiedstring(date-time)required

When the suggestion was last modified

results[].​metadataobjectrequired

Additional metadata for the suggestion

results[].​metadata.​property name*anyadditional property
results[].​pathway_idstringrequired

The pathway ID being suggested

results[].​pathway_uuidstringrequired

The UUID of the pathway being suggested

results[].​pathway_namestringrequired

The name of the pathway being suggested

results[].​pathway_platform_keystringrequired

The platform key associated with the pathway

results[].​user_countinteger

Number of users in the group

Response
application/json
{
  "count": 0,
  "next_page": "http://example.com",
  "previous_page": "http://example.com",
  "results": [
    { … }
  ]
}

catalog_suggestions_pathway_manage_group_create

Request

API View for managing pathway group suggestions.

This endpoint allows administrators to view, create, and delete pathway suggestions for groups of users within a platform.

Query Parameters (GET): platform_key (str, required): The platform to retrieve group suggestions for platform_org (str, optional): The organization identifier for the platform query (str, optional): Search term to filter group suggestions sort (str, optional): Field to sort results by (default: 'id') department_mode (bool, optional): Filter suggestions by department admin access page (int, optional): Page number for pagination page_size (int, optional): Number of items per page

Methods: GET: Retrieve a paginated list of pathway group suggestions for a platform POST: Create or update a pathway group suggestion DELETE: Remove a pathway group suggestion

Request Body (POST): A JSON object containing:

  • platform_key (str, required): The platform for the group suggestion
  • pathway_id (str, required): The pathway ID to suggest
  • group_id (str/int, required): The group to suggest the pathway to
  • accepted (bool, optional): Whether the suggestion is accepted
  • visible (bool, optional): Whether the suggestion is visible
  • metadata (dict, optional): Additional suggestion metadata

Query Parameters (DELETE): suggestion_id (int, required): The ID of the group suggestion to delete

Returns: GET: A paginated JSON response containing pathway group suggestions: { "count": 5, "next": "https://example.com/api/catalog/suggestions/pathway/group/?page=2", "previous": null, "results": [ { "id": 123, "group_id": 789, "group_name": "Engineering Team", "platform_key": "platform1", "accepted": false, "visible": true, "created": "2023-06-15T14:30:00Z", "modified": "2023-06-15T14:30:00Z", "metadata": {}, "pathway_id": "pathway-v1:org+pathway+run", "pathway_uuid": "12345678-1234-5678-1234-567812345678", "pathway_name": "Data Science Pathway", "pathway_platform_key": "platform1", "user_count": 25 }, ... ] }

POST: A JSON response containing the created/updated group suggestion: { "id": 123, "group_id": 789, "group_name": "Engineering Team", "platform_key": "platform1", "accepted": false, "visible": true, "created": "2023-06-15T14:30:00Z", "modified": "2023-06-15T14:30:00Z", "metadata": {}, "pathway_id": "pathway-v1:org+pathway+run", "pathway_uuid": "12345678-1234-5678-1234-567812345678", "pathway_name": "Data Science Pathway", "pathway_platform_key": "platform1", "user_count": 25 }

DELETE: A success response with status 200

Error Responses: 400 Bad Request: If required parameters are missing or invalid, or if group suggestion operations fail 401 Unauthorized: If the user is not authenticated 403 Forbidden: If the user does not have permission to manage group suggestions 500 Internal Server Error: If an unexpected error occurs

Access Control:

  • Requires IsDMAdmin, IsPlatformAdmin, or IsDepartmentModeAdminInPlatform permission
  • Platform admins can manage group suggestions for their platform
  • Department admins can manage group suggestions for their departments
  • DM admins can manage all group suggestions
Security
PlatformApiKeyAuthentication
Query
department_modeboolean

Filter suggestions by department admin access

pageinteger

Page number for pagination

page_sizeinteger

Number of items per page

platform_keystringnon-emptyrequired

The platform to retrieve group suggestions for

platform_orgstringnon-empty

The organization identifier for the platform

querystringnon-empty

Search term to filter group suggestions

sortstringnon-empty

Field to sort results by

Default "id"
Body
required
platform_keystringrequired

The platform for the group suggestion

platform_orgstring

The organization identifier for the platform

pathway_uuidstringrequired

The pathway UUID to suggest

group_idintegerrequired

The group to suggest the pathway to

acceptedboolean

Whether the suggestion is accepted

Default false
visibleboolean

Whether the suggestion is visible

Default true
metadataobject

Additional suggestion metadata

suggested_bystring

The user who suggested the group

department_modeboolean

Flag to ensure department admins can call the API

Default false
curl -i -X POST \
  'https://docs.ibl.ai/_mock/apis/ibl/api/catalog/suggestions/pathway/manage/group/?department_mode=true&page=0&page_size=0&platform_key=string&platform_org=string&query=string&sort=id' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "platform_key": "string",
    "platform_org": "string",
    "pathway_uuid": "string",
    "group_id": 0,
    "accepted": false,
    "visible": true,
    "metadata": {
      "property1": null,
      "property2": null
    },
    "suggested_by": "string",
    "department_mode": false
  }'

Responses

Bodyapplication/json
idintegerrequired

The unique identifier for the group suggestion

group_idintegerrequired

The ID of the group receiving the suggestion

group_namestringrequired

The name of the group receiving the suggestion

platform_keystringrequired

The platform key associated with the suggestion

acceptedboolean

Whether the suggestion has been accepted

visiblebooleanrequired

Whether the suggestion is visible

createdstring(date-time)required

When the suggestion was created

modifiedstring(date-time)required

When the suggestion was last modified

metadataobjectrequired

Additional metadata for the suggestion

metadata.​property name*anyadditional property
pathway_idstringrequired

The pathway ID being suggested

pathway_uuidstringrequired

The UUID of the pathway being suggested

pathway_namestringrequired

The name of the pathway being suggested

pathway_platform_keystringrequired

The platform key associated with the pathway

user_countinteger

Number of users in the group

Response
application/json
{
  "id": 0,
  "group_id": 0,
  "group_name": "string",
  "platform_key": "string",
  "accepted": true,
  "visible": true,
  "created": "2019-08-24T14:15:22Z",
  "modified": "2019-08-24T14:15:22Z",
  "metadata": {
    "property1": null,
    "property2": null
  },
  "pathway_id": "string",
  "pathway_uuid": "string",
  "pathway_name": "string",
  "pathway_platform_key": "string",
  "user_count": 0
}

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