first commit

packages/nodes-base/nodes/Aws/IAM/descriptions/common.ts

@@ -0,0 +1,158 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+import { validateName } from '../helpers/utils';
+
+export const paginationParameters: INodeProperties[] = [
+	{
+		displayName: 'Return All',
+		name: 'returnAll',
+		type: 'boolean',
+		default: false,
+		description: 'Whether to return all results or only up to a given limit',
+	},
+	{
+		displayName: 'Limit',
+		name: 'limit',
+		default: 100,
+		type: 'number',
+		validateType: 'number',
+		typeOptions: {
+			minValue: 1,
+		},
+		description: 'Max number of results to return',
+		displayOptions: {
+			hide: {
+				returnAll: [true],
+			},
+		},
+		routing: {
+			send: {
+				property: 'MaxItems',
+				type: 'body',
+				value: '={{ $value }}',
+			},
+		},
+	},
+];
+
+export const userLocator: INodeProperties = {
+	displayName: 'User',
+	name: 'user',
+	required: true,
+	type: 'resourceLocator',
+	default: {
+		mode: 'list',
+		value: '',
+	},
+	modes: [
+		{
+			displayName: 'From list',
+			name: 'list',
+			type: 'list',
+			typeOptions: {
+				searchListMethod: 'searchUsers',
+				searchable: true,
+			},
+		},
+		{
+			displayName: 'By Name',
+			name: 'userName',
+			type: 'string',
+			placeholder: 'e.g. Admins',
+			hint: 'Enter the user name',
+			validation: [
+				{
+					type: 'regex',
+					properties: {
+						regex: '^[\\w+=,.@-]+$',
+						errorMessage: 'The user name must follow the allowed pattern',
+					},
+				},
+			],
+		},
+	],
+};
+
+export const groupLocator: INodeProperties = {
+	displayName: 'Group',
+	name: 'group',
+	required: true,
+	type: 'resourceLocator',
+	default: {
+		mode: 'list',
+		value: '',
+	},
+	modes: [
+		{
+			displayName: 'From list',
+			name: 'list',
+			type: 'list',
+			typeOptions: {
+				searchListMethod: 'searchGroups',
+				searchable: true,
+			},
+		},
+		{
+			displayName: 'By Name',
+			name: 'groupName',
+			type: 'string',
+			placeholder: 'e.g. Admins',
+			hint: 'Enter the group name',
+			validation: [
+				{
+					type: 'regex',
+					properties: {
+						regex: '^[\\w+=,.@-]+$',
+						errorMessage: 'The group name must follow the allowed pattern.',
+					},
+				},
+			],
+		},
+	],
+};
+
+export const pathParameter: INodeProperties = {
+	displayName: 'Path',
+	name: 'path',
+	type: 'string',
+	validateType: 'string',
+	default: '/',
+};
+
+export const groupNameParameter: INodeProperties = {
+	displayName: 'Group Name',
+	name: 'groupName',
+	required: true,
+	type: 'string',
+	validateType: 'string',
+	typeOptions: {
+		maxLength: 128,
+		regex: '^[+=,.@\\-_A-Za-z0-9]+$',
+	},
+	default: '',
+	placeholder: 'e.g. GroupName',
+	routing: {
+		send: {
+			preSend: [validateName],
+		},
+	},
+};
+
+export const userNameParameter: INodeProperties = {
+	displayName: 'User Name',
+	name: 'userName',
+	required: true,
+	type: 'string',
+	validateType: 'string',
+	default: '',
+	placeholder: 'e.g. JohnSmith',
+	typeOptions: {
+		maxLength: 64,
+		regex: '^[A-Za-z0-9+=,\\.@_-]+$',
+	},
+	routing: {
+		send: {
+			preSend: [validateName],
+		},
+	},
+};

packages/nodes-base/nodes/Aws/IAM/descriptions/group/Group.resource.ts

@@ -0,0 +1,145 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+import * as create from './create.operation';
+import * as del from './delete.operation';
+import * as get from './get.operation';
+import * as getAll from './getAll.operation';
+import * as update from './update.operation';
+import { CURRENT_VERSION } from '../../helpers/constants';
+import { handleError } from '../../helpers/errorHandler';
+import {
+	deleteGroupMembers,
+	simplifyGetAllGroupsResponse,
+	simplifyGetGroupsResponse,
+} from '../../helpers/utils';
+
+export const description: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		default: 'getAll',
+		displayOptions: {
+			show: {
+				resource: ['group'],
+			},
+		},
+		options: [
+			{
+				name: 'Create',
+				value: 'create',
+				action: 'Create group',
+				description: 'Create a new group',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'CreateGroup',
+							Version: CURRENT_VERSION,
+							GroupName: '={{ $parameter["groupName"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError],
+					},
+				},
+			},
+			{
+				name: 'Delete',
+				value: 'delete',
+				action: 'Delete group',
+				description: 'Delete an existing group',
+				routing: {
+					send: {
+						preSend: [deleteGroupMembers],
+					},
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'DeleteGroup',
+							Version: CURRENT_VERSION,
+							GroupName: '={{ $parameter["group"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError],
+					},
+				},
+			},
+			{
+				name: 'Get',
+				value: 'get',
+				action: 'Get group',
+				description: 'Retrieve details of an existing group',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'GetGroup',
+							Version: CURRENT_VERSION,
+							GroupName: '={{ $parameter["group"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError, simplifyGetGroupsResponse],
+					},
+				},
+			},
+			{
+				name: 'Get Many',
+				value: 'getAll',
+				action: 'Get many groups',
+				description: 'Retrieve a list of groups',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'ListGroups',
+							Version: CURRENT_VERSION,
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError, simplifyGetAllGroupsResponse],
+					},
+				},
+			},
+			{
+				name: 'Update',
+				value: 'update',
+				action: 'Update group',
+				description: 'Update an existing group',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'UpdateGroup',
+							Version: CURRENT_VERSION,
+							GroupName: '={{ $parameter["group"] }}',
+							NewGroupName: '={{ $parameter["groupName"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError],
+					},
+				},
+			},
+		],
+	},
+
+	...create.description,
+	...del.description,
+	...get.description,
+	...getAll.description,
+	...update.description,
+];

packages/nodes-base/nodes/Aws/IAM/descriptions/group/create.operation.ts

@@ -0,0 +1,43 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { validatePath } from '../../helpers/utils';
+import { groupNameParameter, pathParameter } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...groupNameParameter,
+		description: 'The name of the new group to create',
+		placeholder: 'e.g. GroupName',
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		default: {},
+		options: [
+			{
+				...pathParameter,
+				placeholder: 'e.g. /division_abc/engineering/',
+				description: 'The path to the group, if it is not included, it defaults to a slash (/)',
+				routing: {
+					send: {
+						preSend: [validatePath],
+						property: 'Path',
+						type: 'query',
+					},
+				},
+			},
+		],
+		placeholder: 'Add Option',
+		type: 'collection',
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['group'],
+		operation: ['create'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/group/delete.operation.ts

@@ -0,0 +1,20 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { groupLocator } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...groupLocator,
+		description: 'Select the group you want to delete',
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['group'],
+		operation: ['delete'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/group/get.operation.ts

@@ -0,0 +1,27 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { groupLocator } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...groupLocator,
+		description: 'Select the group you want to retrieve',
+	},
+	{
+		displayName: 'Include Users',
+		name: 'includeUsers',
+		type: 'boolean',
+		default: false,
+		description: 'Whether to include a list of users in the group',
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['group'],
+		operation: ['get'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/group/getAll.operation.ts

@@ -0,0 +1,24 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { paginationParameters } from '../common';
+
+const properties: INodeProperties[] = [
+	...paginationParameters,
+	{
+		displayName: 'Include Users',
+		name: 'includeUsers',
+		type: 'boolean',
+		default: false,
+		description: 'Whether to include a list of users in the group',
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['group'],
+		operation: ['getAll'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/group/update.operation.ts

@@ -0,0 +1,47 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { validatePath } from '../../helpers/utils';
+import { groupLocator, groupNameParameter, pathParameter } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...groupLocator,
+		description: 'Select the group you want to update',
+	},
+	{
+		...groupNameParameter,
+		description: 'The new name of the group',
+		placeholder: 'e.g. GroupName',
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Option',
+		default: {},
+		options: [
+			{
+				...pathParameter,
+				placeholder: 'e.g. /division_abc/engineering/',
+				description: 'The new path to the group, if it is not included, it defaults to a slash (/)',
+				routing: {
+					send: {
+						preSend: [validatePath],
+						property: 'NewPath',
+						type: 'query',
+					},
+				},
+			},
+		],
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['group'],
+		operation: ['update'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/index.ts

@@ -0,0 +1,2 @@
+export * as group from './group/Group.resource';
+export * as user from './user/User.resource';

packages/nodes-base/nodes/Aws/IAM/descriptions/user/User.resource.ts

@@ -0,0 +1,197 @@
+import type { INodeProperties } from 'n8n-workflow';
+
+import * as addToGroup from './addToGroup.operation';
+import * as create from './create.operation';
+import * as del from './delete.operation';
+import * as get from './get.operation';
+import * as getAll from './getAll.operation';
+import * as removeFromGroup from './removeFromGroup.operation';
+import * as update from './update.operation';
+import { CURRENT_VERSION } from '../../helpers/constants';
+import { handleError } from '../../helpers/errorHandler';
+import { removeUserFromGroups, simplifyGetAllUsersResponse } from '../../helpers/utils';
+
+export const description: INodeProperties[] = [
+	{
+		displayName: 'Operation',
+		name: 'operation',
+		type: 'options',
+		noDataExpression: true,
+		default: 'getAll',
+		displayOptions: {
+			show: {
+				resource: ['user'],
+			},
+		},
+		options: [
+			{
+				name: 'Add to Group',
+				value: 'addToGroup',
+				description: 'Add an existing user to a group',
+				action: 'Add user to group',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'AddUserToGroup',
+							Version: CURRENT_VERSION,
+							UserName: '={{ $parameter["user"] }}',
+							GroupName: '={{ $parameter["group"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError],
+					},
+				},
+			},
+			{
+				name: 'Create',
+				value: 'create',
+				description: 'Create a new user',
+				action: 'Create user',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'CreateUser',
+							Version: CURRENT_VERSION,
+							UserName: '={{ $parameter["userName"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError],
+					},
+				},
+			},
+			{
+				name: 'Delete',
+				value: 'delete',
+				description: 'Delete a user',
+				action: 'Delete user',
+				routing: {
+					send: {
+						preSend: [removeUserFromGroups],
+					},
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'DeleteUser',
+							Version: CURRENT_VERSION,
+							UserName: '={{ $parameter["user"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError],
+					},
+				},
+			},
+			{
+				name: 'Get',
+				value: 'get',
+				description: 'Retrieve a user',
+				action: 'Get user',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'GetUser',
+							Version: CURRENT_VERSION,
+							UserName: '={{ $parameter["user"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [
+							{
+								type: 'rootProperty',
+								properties: {
+									property: 'GetUserResponse.GetUserResult.User',
+								},
+							},
+							handleError,
+						],
+					},
+				},
+			},
+			{
+				name: 'Get Many',
+				value: 'getAll',
+				description: 'Retrieve a list of users',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'ListUsers',
+							Version: CURRENT_VERSION,
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError, simplifyGetAllUsersResponse],
+					},
+				},
+				action: 'Get many users',
+			},
+			{
+				name: 'Remove From Group',
+				value: 'removeFromGroup',
+				description: 'Remove a user from a group',
+				action: 'Remove user from group',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'RemoveUserFromGroup',
+							Version: CURRENT_VERSION,
+							UserName: '={{ $parameter["user"] }}',
+							GroupName: '={{ $parameter["group"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError],
+					},
+				},
+			},
+			{
+				name: 'Update',
+				value: 'update',
+				description: 'Update a user',
+				action: 'Update user',
+				routing: {
+					request: {
+						method: 'POST',
+						url: '',
+						body: {
+							Action: 'UpdateUser',
+							Version: CURRENT_VERSION,
+							NewUserName: '={{ $parameter["userName"] }}',
+							UserName: '={{ $parameter["user"] }}',
+						},
+						ignoreHttpStatusErrors: true,
+					},
+					output: {
+						postReceive: [handleError],
+					},
+				},
+			},
+		],
+	},
+
+	...addToGroup.description,
+	...create.description,
+	...del.description,
+	...get.description,
+	...getAll.description,
+	...update.description,
+	...removeFromGroup.description,
+];

packages/nodes-base/nodes/Aws/IAM/descriptions/user/addToGroup.operation.ts

@@ -0,0 +1,24 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { groupLocator, userLocator } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...userLocator,
+		description: 'Select the user you want to add to the group',
+	},
+	{
+		...groupLocator,
+		description: 'Select the group you want to add the user to',
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['user'],
+		operation: ['addToGroup'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/user/create.operation.ts

@@ -0,0 +1,96 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { preprocessTags, validatePath, validatePermissionsBoundary } from '../../helpers/utils';
+import { pathParameter, userNameParameter } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...userNameParameter,
+		description: 'The username of the new user to create',
+		placeholder: 'e.g. UserName',
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Option',
+		default: {},
+		options: [
+			{
+				...pathParameter,
+				description: 'The path for the user name',
+				placeholder: 'e.g. /division_abc/subdivision_xyz/',
+				routing: {
+					send: {
+						preSend: [validatePath],
+						property: 'Path',
+						type: 'query',
+					},
+				},
+			},
+			{
+				displayName: 'Permissions Boundary',
+				name: 'permissionsBoundary',
+				default: '',
+				description:
+					'The ARN of the managed policy that is used to set the permissions boundary for the user',
+				placeholder: 'e.g. arn:aws:iam::123456789012:policy/ExampleBoundaryPolicy',
+				type: 'string',
+				validateType: 'string',
+				routing: {
+					send: {
+						preSend: [validatePermissionsBoundary],
+					},
+				},
+			},
+			{
+				displayName: 'Tags',
+				name: 'tags',
+				type: 'fixedCollection',
+				description: 'A list of tags that you want to attach to the new user',
+				default: [],
+				placeholder: 'Add Tag',
+				typeOptions: {
+					multipleValues: true,
+				},
+				options: [
+					{
+						name: 'tags',
+						displayName: 'Tag',
+						values: [
+							{
+								displayName: 'Key',
+								name: 'key',
+								type: 'string',
+								default: '',
+								placeholder: 'e.g., Department',
+							},
+							{
+								displayName: 'Value',
+								name: 'value',
+								type: 'string',
+								default: '',
+								placeholder: 'e.g., Engineering',
+							},
+						],
+					},
+				],
+				routing: {
+					send: {
+						preSend: [preprocessTags],
+					},
+				},
+			},
+		],
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['user'],
+		operation: ['create'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/user/delete.operation.ts

@@ -0,0 +1,20 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { userLocator } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...userLocator,
+		description: 'Select the user you want to delete',
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['user'],
+		operation: ['delete'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/user/get.operation.ts

@@ -0,0 +1,20 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { userLocator } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...userLocator,
+		description: 'Select the user you want to retrieve',
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['user'],
+		operation: ['get'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/user/getAll.operation.ts

@@ -0,0 +1,43 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { validateUserPath } from '../../helpers/utils';
+import { paginationParameters } from '../common';
+
+const properties: INodeProperties[] = [
+	...paginationParameters,
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Field',
+		default: {},
+		options: [
+			{
+				displayName: 'Path Prefix',
+				name: 'pathPrefix',
+				type: 'string',
+				validateType: 'string',
+				default: '/',
+				description: 'The path prefix for filtering the results',
+				placeholder: 'e.g. /division_abc/subdivision_xyz/',
+				routing: {
+					send: {
+						preSend: [validateUserPath],
+						property: 'PathPrefix',
+						value: '={{ $value }}',
+					},
+				},
+			},
+		],
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['user'],
+		operation: ['getAll'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/user/removeFromGroup.operation.ts

@@ -0,0 +1,51 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { groupLocator, userLocator } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...userLocator,
+		description: 'Select the user you want to remove from the group',
+	},
+	{
+		...groupLocator,
+		description: 'Select the group you want to remove the user from',
+		modes: [
+			{
+				displayName: 'From list',
+				name: 'list',
+				type: 'list',
+				typeOptions: {
+					searchListMethod: 'searchGroupsForUser',
+					searchable: true,
+				},
+			},
+			{
+				displayName: 'By Name',
+				name: 'groupName',
+				type: 'string',
+				hint: 'Enter the group name',
+				validation: [
+					{
+						type: 'regex',
+						properties: {
+							regex: '^[\\w+=,.@-]+$',
+							errorMessage: 'The group name must follow the allowed pattern',
+						},
+					},
+				],
+				placeholder: 'e.g. Admins',
+			},
+		],
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['user'],
+		operation: ['removeFromGroup'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);

packages/nodes-base/nodes/Aws/IAM/descriptions/user/update.operation.ts

@@ -0,0 +1,45 @@
+import type { INodeProperties } from 'n8n-workflow';
+import { updateDisplayOptions } from 'n8n-workflow';
+
+import { validatePath } from '../../helpers/utils';
+import { pathParameter, userLocator, userNameParameter } from '../common';
+
+const properties: INodeProperties[] = [
+	{
+		...userLocator,
+		description: 'Select the user you want to update',
+	},
+	{
+		...userNameParameter,
+		description: 'The new name of the user',
+	},
+	{
+		displayName: 'Additional Fields',
+		name: 'additionalFields',
+		type: 'collection',
+		placeholder: 'Add Option',
+		default: {},
+		options: [
+			{
+				...pathParameter,
+				placeholder: 'e.g. /division_abc/subdivision_xyz/',
+				routing: {
+					send: {
+						preSend: [validatePath],
+						property: 'NewPath',
+						type: 'query',
+					},
+				},
+			},
+		],
+	},
+];
+
+const displayOptions = {
+	show: {
+		resource: ['user'],
+		operation: ['update'],
+	},
+};
+
+export const description = updateDisplayOptions(displayOptions, properties);