Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.petrasecurity.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Only Admins and members with the Can Manage Tenants permission (Full Members and Sales members) can pause or remove tenants.

​
Pause a tenant

Pausing a tenant stops monitoring and removes it from billing, but retains all data. You can resume a paused tenant at any time without re-onboarding.
  1. Go to Settings > Usage.
  2. Find the tenant you want to pause.
  3. Click Pause tenant.
  4. Confirm the pause.
You can also schedule a pause for a future date instead of pausing immediately.

​
What happens when you pause

  • Monitoring stops immediately.
  • The tenant is excluded from your billable identities count.
  • All existing data (incidents, logs, users) is retained.
  • Members and guests lose access to the tenant while it is paused.

​
Resume a paused tenant

  1. Go to Settings > Usage.
  2. Find the paused tenant.
  3. Click Resume tenant.
Petra automatically backfills activity from the paused period, so you don’t lose coverage for the time the tenant was paused.

​
Remove a tenant

Removing a tenant stops monitoring and removes access for that tenant in Petra.
  1. Go to Settings > Usage.
  2. Find the tenant you want to remove.
  3. Click Remove tenant.
  4. Confirm the removal.
Self-serve tenant management

​
What happens when you remove

  • Monitoring for the tenant stops immediately.
  • Access to that tenant in Petra is removed for your members and guests.
  • You can add the tenant back later by onboarding it again.

​
Optional: Remove the enterprise application in Azure

After removing the tenant in Petra, you can optionally delete the Petra enterprise application from your Microsoft Entra (Azure AD) tenant. This is not required for Petra, but some organizations prefer to fully clean up access.
  1. Sign in to the Microsoft Entra admin center with at least the Cloud Application Administrator role.
  2. Go to Entra ID > Enterprise applications > All applications.
  3. Search for the Petra application (service principal) and select it.
  4. In Properties, select Delete and confirm.
Note: Deleted enterprise applications remain in the recycle bin for 30 days and can be restored during that period. For full instructions, see Microsoft’s guide: Delete an enterprise application using Microsoft Entra admin center.