You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs/release-notes). info

> [!NOTE]
> Was this troubleshooting playbook helpful? Please let us know by clicking [Send Feedback]().

## Symptom

You might encounter one or more of the following issues caused by communication issues between
the Developer Portal and Edge:

1. Unable to perform the following tasks:
2. Create or update SmartDocs.
3. Register developer apps.
4. List API products.
5. Error returned when accessing SmartDocs models page on Developer Portal (select **Content \> SmartDocs** in the Developer Portal administration menu).

   <br />


   ![](https://docs.apigee.com/static/api-platform/images/Portal-Img-1.png)
6. Developer app analytics not being generated.

## Error Messages

1. Error returned when accessing the "SmartDocs" tab in the developer portal:  

   ```
   The website encountered an unexpected error. Please try again later.
   ```
2. Error returned when registering a developer app in the developer portal:  

   ```
   There was an error trying to create the App. Please try again later.
   ```

## Possible Causes

In most cases, the problem is due to **incorrect devadmin
credentials** specified or **insufficient permissions** assigned to
the devadmin user role.

Validate the Edge connection configuration for the dev portal by navigating to
**Configuration \> Dev Portal** and ensuring the Connection Status field
displays Connection Successful. Otherwise, the dev portal is not able to properly connect to the
Edge Management server.

## Diagnosis

1. Enable "**DEBUG** " logging on the dev portal by navigating to **Configuration \> Dev Portal** and selecting Debug under Edge logging threshold. By default, Management API calls are not logged.

<!-- -->

2. Reproduce the problem.

<!-- -->

3. Access the log by navigating to **Reports -\> Recent Log
   Messages**.

![](https://docs.apigee.com/static/api-platform/images/Portal-Img-6.png)

4. Open the "Message" of type "LogPlugin" to learn more about the actual error.

**Sample output showing 401 Unauthorized Error**

![](https://docs.apigee.com/static/api-platform/images/Portal-Img-3.png)

## Resolution

Follow the appropriate steps listed in the below table depending on the error encountered:

|---|---|
| **Error** | **Steps to Resolve** |
| 401 Unauthorized | Update the correct devadmin credentials on Developer Portal and test connectivity again. See [Add and manage user accounts](). |
| 403 Forbidden | Update the devadmin userrole on Edge organization to have the required permissions for the resource. See [Setting user roles and permissions](). |