Configurar el aprovisionamiento de SCIM con la API SCIM de Udemy

Descripción general

System for Cross-domain Identity Management (SCIM) es una API para la automatización del aprovisionamiento y desaprovisionamiento de usuarios y grupos, así como para la actualización de datos de usuarios y grupos del proveedor de identidad (IdP) del cliente en la cuenta de Udemy Business.SCIM es compatible con diferentes proveedores de identidad, como Okta, Azure AD y OneLogin. Además, también puedes utilizar la API SCIM de Udemy Business en caso de que uses otros proveedores de identidad o tus propias herramientas.

Si tu organización utiliza uno de los siguientes proveedores de identidad, consulta las siguientes guías para configurar el aprovisionamiento de SCIM:

SCIM utiliza una API REST estandarizada con datos en formato JSON. Udemy Business es compatible con la versión 2.0 del estándar SCIM. La API está disponible para todos los clientes del Plan de empresa.

La API SCIM de Udemy Business es compatible con las siguientes funciones:

  • Aprovisionamiento de usuarios
  • Desaprovisionamiento de usuarios (desactivación)
  • Cambio de direcciones de correo electrónico
  • Cambio de los detalles del usuario
  • Aprovisionamiento de grupos
  • Adición/eliminación de usuarios en grupos

Descripción del protocolo SCIM

El protocolo SCIM es un protocolo REST de nivel de aplicación para aprovisionar y gestionar los datos de identidad en el sitio web. El protocolo es un modelo cliente-servidor en el que el cliente es el proveedor de identidad (IdP) y el servidor es Udemy Business.

El flujo básico es:

  • Cuando el cliente concede acceso a Udemy Business al usuario en el IdP, el IdP nos envía una solicitud para comprobar si el usuario específico existe en nuestra base de datos. Nos envía una solicitud de búsqueda de usuario mediante un atributo como userName o email.
  • Si el usuario no existe, el IdP envía una solicitud para crear un usuario.
  • Si el usuario existe, el IdP envía una solicitud de actualización para el usuario.
  • Cuando se revoca el acceso a Udemy Business, el IdP nos envía una solicitud para desactivar al usuario de nuestra base de datos.
  • El IdP también puede enviar solicitudes para cambiar los detalles del usuario.

¿Cómo se accede a la API?

Para obtener las credenciales de autorización que permiten conectarse a la API SCIM, deberás configurar la integración de SCIM mediante la página Gestionar -> Configuración -> Aprovisionamiento (SCIM) en tu cuenta de Udemy Business. Ten en cuenta que sólo los administradores tienen acceso a esta página.

Haz clic en Comenzar configuración.

provisioning_scim.png

Ahora, selecciona Elegir proveedor y, a continuación, Personalizado.

select_provider.png

Haz clic en Generar token.

generate_token.png

En esta pantalla, haz clic en Copiar para copiar el token de portador en el portapapeles.

copy_bearer_token.png

 

Deberás incluir el encabezado HTTP Autorización con el token de portador en tus solicitudes, por ejemplo:

GET /scim/v2/Users HTTP/1.1
Host: myorganization.udemy.com
Accept: application/scim+json
Authorization: Bearer <enter you Bearer token here>
Content-Type: application/scim+json

La API SCIM de Udemy Business utiliza el protocolo HTTP y solo está disponible mediante una conexión HTTPS segura.

La URL base para la API es: https://<yoursubdomain>.udemy.com/scim/v2/.

Si estás desarrollando una aplicación para interactuar con la API SCIM de Udemy Business, se recomienda consultar los RFC SCIM incluidos al final de este documento. La implementación de la API SCIM de Udemy Business cumple con el estándar.

Límite de tasa

Udemy Business aplica un límite de tasa a la API SCIM según el protocolo de límite de tasa HTTP estándar. Si tu solicitud se ve afectada por el límite de tasa, recibirás una respuesta HTTP 429 y deberás esperar e intentarlo de nuevo de acuerdo con el valor especificado en la cabecera Retry-After.

Endpoints de la API SCIM

Endpoints informativos

Estos endpoints son informativos y sirven para configurar los clientes. No requieren autenticación, por lo que no necesitas incluir encabezado de autorización al acceder a estos endpoints.

GET /ServiceProviderConfig

Proporciona detalles sobre la implementación de SCIM de Udemy Business, incluidos los métodos compatibles.

GET /Schemas

Proporciona información sobre los esquemas compatibles con nuestra implementación de SCIM. Los esquemas compatibles son Usuarios y Grupos.

GET /Schemas/Users

Proporciona todos los atributos compatibles con los recursos de usuario.

GET /Schemas/Groups

Proporciona todos los atributos compatibles con los recursos de grupo.

Endpoints de usuario

Usar estos endpoints te permite crear listas de usuarios, filtrar por atributos, agregar nuevos usuarios, actualizar la información del usuario o desactivar/anonimizar usuarios.

Si la API SCIM no devuelve todos los usuarios, ponte en contacto con el equipo de asistencia de Udemy Business.

Atributos admitidos

 

Atributo de SCIM ¿Necesario? Descripción  
emails[type=”work”]]['value’]
 Sí El correo electrónico del usuario. Debe ser único 
userName
 Sí El nombre de usuario del IdP. Debe ser único. 
activo
 Sí Marcar para desactivar/reactivar usuarios 
externalId
 Sí El ID externo del usuario en IdP. Debe ser único. 
urn:ietf:params:scim:schemas:extension:
enterprise:2.0:User:employeeNumber
 Sí Devuelve el campo employeeNumber de EnterpriseSchema y lo almacena como el campo external_id 
name.givenName
 No El nombre del usuario. Aunque no se requieren, recomendamos especificar siempre estos atributos, ya que resultará más sencillo identificar a los usuarios. 
name.familyName
 No Los apellidos del usuario. Aunque no se requieren, recomendamos especificar siempre estos atributos, ya que resultará más sencillo identificar a los usuarios. 
nombre, { givenName, familyName }
 No El nombre y el apellido del usuario. Aunque no se requieren, recomendamos especificar siempre estos atributos, ya que resultará más sencillo identificar a los usuarios. 
title
 No Función o título del usuario, p. ej., “Ingeniero sénior” 
groups
 No Grupos de SCIM a los que pertenece el usuario


Nota: si especificas otro atributo que no esté en la lista, se ignorará.

GET /Users

Proporciona una lista de usuarios paginada, con 12 usuarios por página de forma predeterminada. Puedes utilizar los parámetros

count

y

startIndex

para paginar el conjunto de resultados. Por ejemplo: 

GET /scim/v2/Users?startIndex=1&count=100 HTTP/1.1

 Host: myorganization.udemy.com

 Accept: application/scim+json

 Authorization: Bearer <enter you Bearer token here>
startIndex
  • es el índice basado en 1 del primer resultado en el conjunto actual de los resultados de la lista (compensación)
  • count es el número de recursos encontrados en una página de respuesta de la lista (límite).
    No puedes recuperar más de 1000 usuarios en una única solicitud. Si este elemento se omite, el límite cambiará a 12 de forma predeterminada.

Solicitud de ejemplo

GET https://demo.udemy.com/scim/v2/Users 
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"totalResults": 18,
"startIndex": 1,
"Resources": [
{
"id": "KwLzN3",
"externalId": "00u3mlhj4x1E482sK5d7",
"userName": "firstName.lastName@domain.com",
"name": {
"givenName": "firstName",
"familyName": "lastName",
"formatted": "firstName lastName"
},
"emails": [
{
"value": "firstName.lastName@domain.com",
"type": "work",
"primary": true
}
],
"title": "",
"active": true,
"groups": [
{
"value": "NZOaw",
"display": "Group Test",
"$ref": "https://demo.udemy.com/scim/v2/Groups/NZOaw"
},
{
"value": "dn1K8",
"display": "NewGroup2",
"$ref": "https://demo.udemy.com/scim/v2/Groups/dn1K8"
}
],
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"meta": {
"resourceType": "User",
"location": "https://demo.udemy.com/scim/v2/Users/KwLzN3",
"created": "2022-01-19T01:11:59Z",
"lastModified": "2024-11-22T21:58:48Z"
},
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "64e63"
}
},
[...]
],
"itemsPerPage": 12
}

 

GET /Users?filter=

Este endpoint se utiliza para filtrar usuarios por atributos específicos. Por ejemplo, es posible buscar por el atributo userName:

GET /Users?filter=userName eq "example..name”

Nota: En el ejemplo anterior, deberás codificar con URL los parámetros de URL de modo que la URL sea:

GET /Users?filter=userName%20eq%20%22example.name%22

Proporcionará una lista de recursos de usuarios. Si no hay resultados, se mostrará una lista vacía.

GET Users?filter=groups.value eq "{SCIM_Group_ID}"

Esto devolverá todos los usuarios que pertenecen a este grupo de SCIM

Los filtros compatibles son:

userName
externalID
emails[type eq=”work”]
groups

Los operadores compatibles son:

and
eq

Respuesta:

  • Código de estado de HTTP 200 con la lista de entidades correcta
  • Código de estado de HTTP 501 si se proporciona un filtro no compatible
POST /Users

Este endpoint se utiliza para crear (aprovisionar) nuevos usuarios en Udemy Business.

La respuesta contendrá un atributo

id

que deberá utilizarse al referirse a este usuario en todas las solicitudes posteriores.

Ten en cuenta que:

  • Los nuevos usuarios creados de este modo no consumirán una licencia hasta que inicien sesión por primera vez.
  • En este momento, si existía una invitación pendiente para este usuario, se utilizará.
    Se añadirá al usuario a grupos, se le asignarán tareas de función/curso adecuadas en función de lo especificado en la invitación.
  • Si se intenta crear un usuario que ya existe en Udemy Business, SCIM pasará a gestionar dicho usuario (se mostrará con un pequeño icono de enlace en la página Gestionar usuarios). Ten en cuenta que el estado del usuario y el uso de la licencia no se modificarán. Si el usuario estaba activo, seguirá activo y si el usuario estaba desactivado, permanecerá desactivado.

Solicitud de ejemplo

 

POST https://demo.udemy.com/scim/v2/Users 
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"active": true,
"emails": [
{
"primary": true,
"type": "work",
"value": "demo.user@test.com"
}
],
"externalId" : "externalIdValue",
"meta": {
"resourceType": "User"
},
"userName": "DemoTest",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "externalIdValue"
},
"name": {
"familyName": "Test",
"formatted": "formatted",
"givenName": "Demo"
}
}

Respuesta de ejemplo

{
"id": "MPD698",
"name": {
"givenName": "Demo",
"familyName": "Test",
"formatted": "Demo Test"
},
"emails": [
{
"value": "demo.user@test.com",
"type": "work",
"primary": true
}
],
"title": "",
"active": true,
"groups": [],
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"meta": {
"resourceType": "User",
"location": "https://demo.udemy.com/scim/v2/Users/MPD698",
"created": "2024-12-27T22:00:25Z",
"lastModified": "2024-12-27T22:00:26Z"
},
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "externalIdValue"
},
"userName": "DemoTest",
"externalId": "externalIdValue"
}

 

Respuesta:

  • Código de estado de HTTP 201 y el recurso del usuario correcto
  • Código de estado de HTTP 409 si el miembro con el mismo userName ya existe en la organización
  • Código de estado de HTTP 400 con los detalles del error en el cuerpo de la respuesta si la solicitud no ha pasado la validación
GET /Users/<id>

Este endpoint se utiliza a fin de recuperar los detalles de un usuario específico. El parámetro

id

en la anterior solicitud es un identificador único que se proporcionó cuando el usuario se creó con SCIM o al elaborar la lista de todos los usuarios existentes.

Respuesta:

  • Código de estado de HTTP 200 con el recurso del usuario correcto
  • Código de estado de HTTP 404 si no se ha encontrado el usuario
PUT /Users/<id>

El endpoint se utiliza para sustituir (sobrescribir) los detalles del usuario en Udemy Business. Si se especifica, el atributo active puede utilizarse para desactivar o reactivar el usuario.

Solicitud de ejemplo:

PUT https://demo.udemy.com/scim/v2/Users/MPD698
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"id": "MPD698",
"userName": "demo.user@test.com",
"externalId": "NewExternalID",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "NewExternalID"
},
"name": {
"givenName": "demo",
"familyName": "user"
},
"emails": [
{
"value": "demo.user@test.com",
"type": "work",
"primary": true
}
],
"active": true
}

Respuesta de ejemplo

{
"id": "MPD698",
"name": {
"givenName": "demo",
"familyName": "user",
"formatted": "demo user"
},
"emails": [
{
"value": "demo.user@test.com",
"type": "work",
"primary": true
}
],
"title": "",
"active": true,
"groups": [],
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"meta": {
"resourceType": "User",
"location": "https://demo.udemy.com/scim/v2/Users/MPD698",
"created": "2024-12-27T22:00:25Z",
"lastModified": "2024-12-27T22:17:52Z"
},
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "NewExternalID"
},
"userName": "demo.user@test.com",
"externalId": "NewExternalID"
}

 

Respuesta:

  • Código de estado de HTTP 200 y el recurso de usuario actualizado
  • Código de estado de HTTP 404 si el usuario no existe.
  • Código de estado de HTTP 400 en caso de intento de desactivar a un propietario de organización.
PATCH /Users/<id>

Este endpoint se utiliza para realizar actualizaciones parciales en los detalles del usuario en nuestro sistema, lo que significa que puedes utilizarlo para cambiar solamente algunos atributos del usuario. A diferencia de PUT, que sustituye al usuario en su totalidad. 

Puede contener el atributo active, que provocará que se desactive o reactive al usuario.

  • El cuerpo de cada solicitud DEBE contener el atributo "schemas" con el valor URI de "urn:ietf:params:scim:api:messages:2.0:PatchOp".
  • El cuerpo de una solicitud de HTTP PATCH DEBE contener el atributo "Operations", cuyo valor es un conjunto de una o más operaciones PATCH.Cada objeto de operación PATCH DEBE tener exactamente un miembro "op", cuyo valor indica la operación que se va a realizar y que SERÁ la de "añadir", "eliminar" o "sustituir".
  • El atributo “path” puede estar vacío, en este caso, “value” debería ser un diccionario con el formato {“path”: “value”}.

Solicitud de ejemplo

PATCH https://demo.udemy.com/scim/v2/Users/MPD698 
{
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:PatchOp"
],
"Operations": [ 
{
"op": "replace",
"path": "userName",
"value": "DemoUserName"
}
]
}

Respuesta de ejemplo

{
"id": "MPD698",
"name": {
"givenName": "demo",
"familyName": "user",
"formatted": "demo user"
},
"emails": [
{
"value": "demo.user@test.com",
"type": "work",
"primary": true
}
],
"title": "",
"active": true,
"groups": [
{
"value": "5ypNz",
"display": "NewGroup",
"$ref": "https://demo.udemy.com/scim/v2/Groups/5ypNz"
}
],
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
],
"meta": {
"resourceType": "User",
"location": "https://demo.udemy.com/scim/v2/Users/MPD698",
"created": "2024-12-27T22:00:25Z",
"lastModified": "2024-12-27T22:17:52Z"
},
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "NewExternalID"
},
"userName": "DemoUserName",
"externalId": "NewExternalID"
}

Respuesta:

  • Código de estado de HTTP 200 con el recurso del usuario actualizado correcto
  • Código de estado de HTTP 404 si no se ha encontrado el usuario
  • Código de estado de HTTP 400 en caso de intento de desactivar a un propietario de organización o de una operación inválida.

Endpoints de grupo

Atributos admitidos

Atributo de SCIM

¿Necesario?

Descripción 

 
displayName

Sí

Título del grupo. Debe ser único entre todos los grupos de Udemy Business.

 
externalId

No

El ID externo del grupo del proveedor de identidad

Nota: si especificas otro atributo que no esté en la lista, se ignorará.

GET /Groups

Este endpoint se utiliza para obtener una lista de paginación de todos los grupos aprovisionados. Incluye los parámetros de cadena de consulta de startIndex y count para paginar los resultados. 

Ten en cuenta que sólo se proporcionarán los grupos creados utilizando SCIM. No se mostrarán los grupos creados para Udemy Business.

Solicitud de ejemplo

GET https://demo.udemy.com/scim/v2/scim/v2/Groups
 "schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"totalResults": 6,
"startIndex": 1,
"Resources": [
{
"id": "NZOaw",
"displayName": "Group Test",
"members": [
{
"value": "KwLzN3",
"display": "firstName lastName",
"type": "User",
"$ref": "https://demo.udemy.com/scim/v2/Users/KwLzN3"
},
{
"value": "eBmzpr",
"display": "user four",
"type": "User",
"$ref": "https://demo.udemy.com/scim/v2/Users/eBmzpr"
}
],
"externalId": null,
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Group"
],
"meta": {
"resourceType": "Group",
"location": "https://demo.udemy.com/scim/v2/Groups/NZOaw",
"created": "2024-08-23T22:26:48Z",
"lastModified": "2024-08-23T22:26:48Z"
}
},
[...]
],
"itemsPerPage": 12
}
GET /Groups?filter=

Este endpoint se utiliza para filtrar grupos por atributos específicos. Por ejemplo, es posible buscar por el atributo displayName:

GET /Groups?filter=displayName eq "Marketing”

Proporcionará una lista de recursos de grupo. Si no hay resultados, se mostrará una lista vacía.

Ten en cuenta que deberás codificar con URL los parámetros, de modo que la solicitud sea:

GET /Groups?filter=displayName%20eq%20%22Marketing%22

Los filtros compatibles son:

displayName
externalId
Id
member.value

Los operadores compatibles son:

and
eq

Respuesta:

  • Código de estado de HTTP 200 con la lista de entidades correcta
  • Código de estado de HTTP 501 si se utiliza el filtro no compatible
POST /Groups

Este endpoint se utiliza para crear (aprovisionar) nuevos grupos en Udemy Business. 

Respuesta:

  • Código de estado de HTTP 409 Si el grupo aprovisonado con el mismo nombre ya existe en la organización, mostraremos 409 (conflicto) con un código de error scimType de exclusividad.
  • Cuando el grupo se haya creado correctamente, mostraremos la representación completa del grupo con el código de estado HTTP 201 (creado) junto con el encabezado de ubicación que contiene la URL del recurso de grupo creado.
GET /Groups/<id>

Este endpoint se utiliza para adquirir los detalles de grupo de Udemy Business.

Respuesta:

  • Código de estado de HTTP 200 y el recurso de grupo
  • Código de estado de HTTP 404 si no se ha encontrado el grupo
POST /Groups

Este endpoint se utiliza para crear (aprovisionar) nuevos grupos en Udemy Business.

Advertencia: Si utilizas el endpoint POST o PUT /scim/v2/Groups para crear grupos, no incluyas el atributo members en la solicitud. Se ignorará cualquier miembro especificado. Para añadir usuarios a un grupo, primero crea el grupo y, a continuación, haz llamadas separadas a PATCH /scim/v2/Groups/ 

Solicitud de ejemplo 

https://demo.udemy.com/scim/v2/Groups 
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Group"
],
"displayName": "Group1",
"externalId": "234523"
}

Respuesta de ejemplo

{
"id": "vREOw",
"displayName": "Group1",
"members": [],
"externalId": "234523",
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Group"
],
"meta": {
"resourceType": "Group",
"location": "https://demo.udemy.com/scim/v2/Groups/vREOw",
"created": "2025-01-15T22:24:54Z",
"lastModified": "2025-01-15T22:24:54Z"
}
}
PUT /Groups/<id>

Este endpoint se utiliza para sustituir los detalles de grupo en Udemy Business.

Advertencia: Si utilizas el endpoint POST o PUT /scim/v2/Groups para crear grupos, no incluyas el atributo members en la solicitud. Se ignorará cualquier miembro especificado. Para añadir usuarios a un grupo, primero crea el grupo y, a continuación, haz llamadas separadas a PATCH /scim/v2/Groups/ 

Solicitud de ejemplo

PUT https://demo.udemy.com/scim/v2/Groups/vREOw 
{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Group"
],
"displayName": "Group1",
"externalId": "MPD699"
}

Respuesta de ejemplo

{
"id": "vREOw",
"displayName": "Group1",
"members": [],
"externalId": "MPD699",
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Group"
],
"meta": {
"resourceType": "Group",
"location": "https://demo.udemy.com/scim/v2/Groups/vREOw",
"created": "2025-01-08T21:12:53Z",
"lastModified": "2025-01-15T22:35:55Z"
}
}

Respuesta:

  • Código de estado de HTTP 200 y el recurso de grupo actualizado
  • Código de estado de HTTP 404 si el grupo no existe.
  •  
PATCH /Groups/<id>

Este endpoint se utiliza para realizar actualizaciones parciales a los detalles de grupo en Udemy Business.

El endpoint PATCH es más complejo que los demás, ya que admite diferentes tipos de operaciones (que se pueden combinar):

Solicitud de ejemplo

PATCH https://demo.udemy.com/scim/v2/Groups/5ypNz 
{ "schemas": 
["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations":[
{
"op":"add",
"path": "members",
"value":[{
"display": "demo user",
"$ref":"https://demo.udemy.com/scim/v2/Users/MPD698",
"value": "MPD698"
}
] 
} 
]
}

Respuesta de ejemplo

204 No Content
  • La operación de sustitución cambia el valor especificado. En nuestro caso puede ser nombre del grupo o miembros.
  • La operación de eliminación elimina un miembro del grupo.
  • La operación de adición añade miembros al grupo.

Las reglas son las siguientes:

  • Nunca eliminamos a miembros sin aprovisionamiento del grupo (en el caso de la operación para sustituir miembros, por ejemplo).
  • La solicitud de PATCH, independientemente del número de operaciones, DEBE tratarse como atómica.

Las validaciones de entrada son las siguientes:

  • El cuerpo de cada solicitud DEBE contener el atributo "schemas" con el valor URI de "urn:ietf:params:scim:api:messages:2.0:PatchOp".
  • El cuerpo de una solicitud de HTTP PATCH DEBE contener el atributo "Operations", cuyo valor es un conjunto de una o más operaciones PATCH.Cada objeto de operación PATCH DEBE tener exactamente un miembro "op", cuyo valor indica la operación que se va a realizar y que SERÁ la de "añadir", "eliminar" o "sustituir".
  • El atributo “path” puede estar vacío, en este caso, “value” debería ser un diccionario con el formato {“path”: “value”}.
  • Para la operación "Eliminar” se requiere la ruta “members”.
  • Para la operación “Añadir” deben estar presentes las rutas “members” o “externalId”.
  • Para la operación “Sustituir” debe estar presente la ruta “members”. Si no está presente, significa que estamos sustituyendo los detalles del grupo, como el nombre del grupo, pero no los miembros.

Nota:

  • La asignación y cancelación de la asignación de usuarios a un grupo se produce de forma asincrónica, de modo que los cambios no se reflejarán inmediatamente en Udemy Business.
  • No admitimos grupos anidados, por lo que se ignorarán durante esta solicitud.

Respuesta:

  • Código de estado de HTTP 204 si la operación se ha realizado correctamente.
  • Código de estado de HTTP 404 si el grupo no existe.
  • Código de estado de HTTP 404 con los detalles del error si se produce un intento de asignar un grupo a un usuario que no es miembro de la organización.
  • Código de estado de HTTP 400 con los detalles del error en el cuerpo de la respuesta si la solicitud no ha pasado la validación
DELETE /Groups/<id>

Este endpoint se utiliza para eliminar o desaprovisionar un grupo en Udemy Business.

Las reglas son las siguientes:

  • Si el grupo contiene miembros no aprovisionados, elimine los usuarios no aprovisionados del grupo y elimine el registro "OrganizationSCIMGroup".

Respuesta:

  • Código de estado de HTTP 204 si la operación se ha realizado correctamente.
  • Código de estado de HTTP 404 si el grupo no existe.

Leer más

Artículos relacionados

Ponte en contacto con nosotros