Skip to content
API Reference/
/
List users in the system

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

Operations

analytics

Operations

career

Operations

catalog

Operations

core

Operations

credentials

Operations

custom-domains

Operations

features

Operations

media

Operations

notifications

Operations

scim

Operations

Remove members from an existing RBAC group

Request

Remove members from an existing RBAC group using SCIM patch operations

Security
PlatformApiKeyAuthentication
Path
idstringrequired
platform_keystringrequired
Query
formatstring
Enum"json""scim+json"
curl -i -X POST \
  'https://docs.ibl.ai/_mock/apis/ibl/api/orgs/{platform_key}/scim/v2/Groups/{id}/remove_members?format=json' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Body
schemasArray of strings

SCIM schema identifiers

Default ["urn:ietf:params:scim:schemas:core:2.0:Group"]
idstringrequired

RBAC group unique ID (must match existing RBAC group)

displayNamestringrequired

RBAC group display name

descriptionstring

RBAC group description

membersArray of objects

Users to add/remove from the RBAC group

metaobject
Response
{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:Group"
  ],
  "id": "string",
  "displayName": "string",
  "description": "string",
  "members": [
    { … }
  ],
  "meta": {
    "resourceType": "string",
    "created": "string",
    "lastModified": "string",
    "version": "string",
    "location": "string"
  }
}

List users in the system

Request

List users in the system for the specified platform

Security
PlatformApiKeyAuthentication
Path
platform_keystringrequired
Query
formatstring
Enum"json""scim+json"
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/orgs/{platform_key}/scim/v2/Users?format=json' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Body
Array [
schemasArray of stringsrequired

SCIM schema identifiers

totalResultsintegerrequired

Total number of results

ResourcesArray of objectsrequired

List of user resources

Resources[].​property name*anyadditional property
]
Response
[
  {
    "schemas": [ … ],
    "totalResults": 0,
    "Resources": [ … ]
  }
]

Create a new user in the system

Request

Create a new user in the system for the specified platform

Security
PlatformApiKeyAuthentication
Path
platform_keystringrequired
Query
formatstring
Enum"json""scim+json"
Body
required
schemasArray of strings

SCIM schema identifiers

Default ["urn:ietf:params:scim:schemas:core:2.0:User"]
userNamestringrequired

Unique username/email for the user

nameobjectrequired
name.​formattedstringrequired

Full formatted name

name.​familyNamestringrequired

Family/last name

name.​givenNamestringrequired

Given/first name

emailsArray of objects(SCIMEmail)required

User's email addresses

emails[].​valuestring(email)required

Email address

emails[].​primaryboolean

Whether this is the primary email

Default true
emails[].​typestring

Email type (work, home, etc.)

Default "work"
activeboolean

Whether the user is active

Default true
displayNamestring

Display name

localestring

User locale

timezonestring

User timezone

titlestring

Job title

organizationstring

Organization

phoneNumbersArray of objects(SCIMPhoneNumber)

Phone numbers

addressesArray of objects(SCIMAddress)

Addresses

entitlementsArray of strings

User entitlements

rolesArray of strings

User roles

x509CertificatesArray of strings

X.509 certificates

passwordstring

User password

providerstring

Authentication provider

tpaUidstring

Third-party authentication UID

isStaffboolean

Whether the user is a staff member

Default false
updateboolean

Whether to update existing user

Default false
platformOrgsArray of strings

List of platform organizations to link the user to

departmentIdsArray of integers

List of department IDs to make the user a member of

groupIdsArray of integers

List of group IDs to add the user to

rbacGroupUniqueIdsArray of strings

List of RBAC group unique IDs to add the user to

metaobject
curl -i -X POST \
  'https://docs.ibl.ai/_mock/apis/ibl/api/orgs/{platform_key}/scim/v2/Users?format=json' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/scim+json' \
  -d '{
    "schemas": [
      "urn:ietf:params:scim:schemas:core:2.0:User"
    ],
    "userName": "string",
    "name": {
      "formatted": "string",
      "familyName": "string",
      "givenName": "string"
    },
    "emails": [
      {
        "value": "user@example.com",
        "primary": true,
        "type": "work"
      }
    ],
    "active": true,
    "displayName": "string",
    "locale": "string",
    "timezone": "string",
    "title": "string",
    "organization": "string",
    "phoneNumbers": [
      {
        "value": "string",
        "type": "string"
      }
    ],
    "addresses": [
      {
        "type": "string",
        "formatted": "string",
        "streetAddress": "string",
        "locality": "string",
        "region": "string",
        "postalCode": "string",
        "country": "string"
      }
    ],
    "entitlements": [
      "string"
    ],
    "roles": [
      "string"
    ],
    "x509Certificates": [
      "string"
    ],
    "password": "string",
    "provider": "string",
    "tpaUid": "string",
    "isStaff": false,
    "update": false,
    "platformOrgs": [
      "string"
    ],
    "departmentIds": [
      0
    ],
    "groupIds": [
      0
    ],
    "rbacGroupUniqueIds": [
      "string"
    ],
    "meta": {
      "resourceType": "string",
      "created": "string",
      "lastModified": "string",
      "version": "string",
      "location": "string"
    }
  }'

Responses

Body
schemasArray of stringsrequired

SCIM schema identifiers

idstringrequired

User ID

userNamestringrequired

Username

nameobjectrequired
name.​formattedstringrequired

Full formatted name

name.​familyNamestringrequired

Family/last name

name.​givenNamestringrequired

Given/first name

emailsArray of objects(SCIMEmail)required

User's email addresses

emails[].​valuestring(email)required

Email address

emails[].​primaryboolean

Whether this is the primary email

Default true
emails[].​typestring

Email type (work, home, etc.)

Default "work"
activebooleanrequired

Whether the user is active

urn_ietf_params_scim_schemas_extension_enterprise_2_0_Userobjectrequired
urn_ietf_params_scim_schemas_extension_enterprise_2_0_User.​edxDataany

edX user data

urn_ietf_params_scim_schemas_extension_enterprise_2_0_User.​userDataany

User metadata

urn_ietf_params_scim_schemas_extension_enterprise_2_0_User.​departmentsArray of objects

List of department memberships

urn_ietf_params_scim_schemas_extension_enterprise_2_0_User.​groupsArray of objects

List of group memberships

urn_ietf_params_scim_schemas_extension_enterprise_2_0_User.​rbacGroupsArray of objects

List of RBAC groups the user belongs to

urn_ietf_params_scim_schemas_extension_enterprise_2_0_User.​platformsArray of objects

List of platforms the user has access to

metaobject
Response
{
  "schemas": [
    "string"
  ],
  "id": "string",
  "userName": "string",
  "name": {
    "formatted": "string",
    "familyName": "string",
    "givenName": "string"
  },
  "emails": [
    { … }
  ],
  "active": true,
  "urn_ietf_params_scim_schemas_extension_enterprise_2_0_User": {
    "edxData": null,
    "userData": null,
    "departments": [ … ],
    "groups": [ … ],
    "rbacGroups": [ … ],
    "platforms": [ … ]
  },
  "meta": {
    "resourceType": "string",
    "created": "string",
    "lastModified": "string",
    "version": "string",
    "location": "string"
  }
}

commerce

Operations

recommendations

Operations

reports

Operations

skills

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