Actions111
- Item Actions
- Webhook Actions
- Collection Actions
- File Actions
- Activity Actions
- Asset Actions
- Authentication Actions
- Extension Actions
- Field Actions
- Folder Actions
- Permission Actions
- Preset Actions
- Relation Actions
- Revision Actions
- Role Actions
- Setting Actions
- User Actions
- Utility Actions
Overview
This n8n node is designed to retrieve information about a specific Role from a Directus instance. It is useful in scenarios where you need to fetch details of a particular role by its unique identifier, such as for user management, permissions auditing, or integration with other systems that require role metadata.
Practical examples:
- Fetching the details of an admin role to display in a dashboard.
- Integrating with another system that needs to verify role properties before assigning users.
- Auditing roles and their permissions within your Directus project.
Properties
| Name | Meaning |
|---|---|
| ID | Primary key of the role. This is a required string value representing the unique identifier (UUID) of the role you want to retrieve. Example: c86c2761-65d3-43c3-897f-6f74ad6a5bd7 |
Output
The output will be a JSON object containing the details of the requested role. The structure typically includes fields such as:
{
"id": "c86c2761-65d3-43c3-897f-6f74ad6a5bd7",
"name": "Admin",
"description": "Administrator role with full access",
"permissions": [/* ... */],
// ...other role-specific fields
}
Note: The exact fields depend on your Directus setup.
Dependencies
- Directus API: Requires access to a running Directus instance.
- Authentication: May require an API key or valid credentials configured in n8n to authenticate requests to Directus.
Troubleshooting
- Invalid ID: If the provided ID does not match any existing role, the node may return an error or an empty result. Double-check the ID value.
- Authentication Errors: If credentials are missing or incorrect, you may see errors related to authentication failure. Ensure your n8n Directus credentials are set up properly.
- Network Issues: If n8n cannot reach the Directus server, check your network connection and Directus server status.