Toolzz Remove alunos de uma classe icon

Toolzz Remove alunos de uma classe

Detach users from Course of Toolzz API

Overview

This n8n custom node, Toolzz Remove alunos de uma classe, is designed to detach (remove) one or more students from a specific class in the Toolzz platform via its API. The node sends a request to the Toolzz API endpoint to remove the specified users from the given class.

Common scenarios:

  • Automating student management workflows, such as unenrolling students at the end of a course.
  • Integrating with other systems to synchronize class rosters.
  • Bulk removal of students based on external triggers or schedules.

Practical example:
You could use this node in an automation that, when triggered by a list of students who have completed a course, automatically removes them from the class in Toolzz.

Properties

Name Type Meaning
AccessToken String The access token used for authenticating requests to the Toolzz API.
Ambiente Options The environment to which the request will be sent (Prod, Homol, Release).
ID Da Turma String The unique identifier of the class from which students will be removed.
IDs Dos Alunos String A comma-separated string of user IDs representing the students to be detached.

Output

The node outputs the JSON response received from the Toolzz API after attempting to detach the students. The structure of this output depends on the API's response, but typically it would include information about the success or failure of the operation and possibly details about the affected users or class.

Dependencies

  • External Service: Toolzz API (https://kong.api.toolzz.com.br or other selected environment)
  • Authentication: Requires a valid AccessToken for API authorization.

Troubleshooting

Common issues:

  • Invalid AccessToken: If the provided access token is invalid or expired, the API will likely return an authentication error. Ensure you are using a current, valid token.
  • Incorrect Class ID or User IDs: Supplying non-existent or incorrect class/user IDs may result in errors or no action taken. Double-check these values.
  • Network/Endpoint Issues: Selecting the wrong environment or if the API endpoint is down/unreachable, requests will fail.

Possible error messages:

  • 401 Unauthorized: Check your AccessToken.
  • 404 Not Found: Verify the Class ID and User IDs.
  • 400 Bad Request: Ensure the Users IDs are correctly formatted (comma-separated).

Links and References

Discussion