Skip to main content

Analysis Fails

An analysis that ends with the Failed status did not produce a new documentation version. Your previous version stays available in the web portal.

When an analysis fails within minutes of starting, the cause is almost always the connection between aprity and your Salesforce org, not the content of the org.

1. The connection to Salesforce was refused​

aprity signs in to your org as the integration user, with the External Client App you created during setup. The analysis fails if:

  • the External Client App was deleted or its policies changed,
  • the integration user's profile was removed from the app's Selected Profiles,
  • the integration user was deactivated, or its username changed,
  • the certificate in the app was replaced.

Fix: check each point in JWT Verification Fails, then start a new analysis.

2. The org was refreshed or copied​

If the org is a sandbox that was refreshed, its Org ID changed. aprity refuses to connect to an org whose Org ID does not match the registered one.

Fix: see Sandbox Refresh.

3. The integration user lost permissions​

The integration user needs the aprity Admin permission set and a profile with API access. If someone changed its profile or removed the permission set, the analysis cannot read the metadata.

Fix: restore the permission set (Setup > Permission Sets > aprity Admin > Manage Assignments) and check the profile.

4. Salesforce API limits were reached​

Every Salesforce org has a daily limit of API calls, shared by all integrations. If the org has used its allocation, aprity cannot read the metadata.

Fix: check Setup > Company Information (API requests in the last 24 hours). Wait for the limit to reset, then start a new analysis. If this happens often, review which integrations use the most API calls.

5. Salesforce was unavailable​

Maintenance or incidents on your Salesforce instance can stop an analysis. Check status.salesforce.com, then start a new analysis once the instance is back.

Starting a new analysis​

After a failed analysis, the weekly analysis limit may prevent you from starting another one right away. See Analysis Refused or Quota Reached. If you cannot start a new analysis, contact support.

Contact support​

Contact aprity support with:

  • The analysis date and time.
  • Your Salesforce Org ID (Setup > Company Information).
  • What changed in the org or its setup recently (new profile, refresh, deleted app).