Agent 365 CLI cleanup command reference

Cleans up ALL resources (blueprint, instance, and Azure). Use subcommands for granular cleanup. The cleanup command provides options to clean up resources that you created during Agent 365 development and deployment. You can clean up all resources at once or use specific subcommands for granular cleanup of different resource types.

Minimum role required: Azure Contributor + Global Administrator

Syntax

a365 cleanup [command] [options]

Options

Option	Description
-n, --agent-name <name>	Agent base name. When provided, no config file is required. The CLI derives resource names the same way as a365 setup all --agent-name.
--tenant-id <tenantId>	Azure AD tenant ID. Overrides auto-detection. Use with --agent-name.
-y, --yes	Skip confirmation prompts and proceed automatically.
--dry-run	Preview the resources that would be deleted across blueprint, Azure, and instance steps without making any changes.
-v, --verbose	Enable verbose logging.
-?, -h, --help	Show help and usage information.

Note

When you pass --agent-name, the CLI first looks up the matching blueprint in Microsoft Entra. If the blueprint isn't found and a local a365.generated.config.json references a different blueprint, the CLI stops to avoid deleting the wrong resources. Run a365 cleanup without --agent-name to clean up the blueprint referenced by the local generated config, or correct the --agent-name value.

cleanup blueprint

Remove Entra ID blueprint application and service principal.

a365 cleanup blueprint [options]

This command removes the agent blueprint application registration and associated service principal from Microsoft Entra ID.

blueprint options

Option	Description
-n, --agent-name <name>	Agent base name. When provided, no config file is required.
--tenant-id <tenantId>	Azure AD tenant ID. Overrides auto-detection. Use with --agent-name.
-y, --yes	Skip confirmation prompts and proceed automatically.
--dry-run	Preview the resources that would be deleted without making any changes.
--endpoint-only	Clear only the messaging endpoint registration, keep the blueprint application.
--m365	Only meaningful with --endpoint-only. When set, clears the messaging endpoint from Teams Graph via MCP Platform. Default is false (opt-in). Ignored (with a warning) for full blueprint cleanup - deleting the blueprint cascades the backend configuration removal on the server side.
-v, --verbose	Enable verbose logging.
-?, -h, --help	Show help and usage information.

cleanup azure

Remove Azure resources (App Service, App Service Plan).

a365 cleanup azure [options]

This command removes the Azure App Service and App Service Plan resources that you created during the deployment process.

azure options

Option	Description
-n, --agent-name <name>	Agent base name. When provided, no config file is required.
--tenant-id <tenantId>	Azure AD tenant ID. Overrides auto-detection. Use with --agent-name.
-y, --yes	Skip confirmation prompts and proceed automatically.
--dry-run	Preview the resources that would be deleted without making any changes.
-v, --verbose	Enable verbose logging.
-?, -h, --help	Show help and usage information.

cleanup instance

Remove agent instance identity and user from Entra ID.

a365 cleanup instance [options]

This command removes the agent instance identity and the associated user account from Microsoft Entra ID.

instance options

Option	Description
-n, --agent-name <name>	Agent base name. When provided, no config file is required.
--tenant-id <tenantId>	Azure AD tenant ID. Overrides auto-detection. Use with --agent-name.
-y, --yes	Skip confirmation prompts and proceed automatically.
--dry-run	Preview the resources that would be deleted without making any changes.
-v, --verbose	Enable verbose logging.
-?, -h, --help	Show help and usage information.