{"title":"Troubleshooting","html":"<p>This guide provides solutions to common issues you might encounter when using the DX Portal and APIs.</p><h2 id=\"authentication-issues\">Authentication Issues</h2><h3 id=\"invalid-client-credentials\">Invalid Client Credentials</h3><p><strong>Problem:</strong> You receive an \"Invalid client credentials\" error when trying to obtain an access token.</p><p><strong>Solution:</strong></p><ul><li>Verify that you're using the correct Client ID and Client Secret.</li><li>Ensure that you're using the correct authentication endpoint for your environment.</li><li>Check that your app has not been disabled or deleted.</li><li>Make sure you're using the correct grant type (<code>client_credentials</code>).</li></ul><h3 id=\"token-expiration\">Token Expiration</h3><p><strong>Problem:</strong> Your API requests fail with an \"Invalid token\" or \"Token expired\" error.</p><p><strong>Solution:</strong></p><ul><li>Access tokens have a limited lifespan (typically 1 hour).</li><li>Request a new access token when the current one expires.</li><li>Implement token refresh logic in your application to automatically obtain a new token when needed.</li></ul><h2 id=\"api-request-issues\">API Request Issues</h2><h3 id=\"invalid-request-format\">Invalid Request Format</h3><p><strong>Problem:</strong> You receive a 400 Bad Request error when making an API call.</p><p><strong>Solution:</strong></p><ul><li>Check that your request body is properly formatted JSON.</li><li>Verify that all required parameters are included.</li><li>Ensure that parameter values are of the correct data type.</li><li>Review the API documentation for the specific endpoint you're calling.</li></ul><h3 id=\"authorization-errors\">Authorization Errors</h3><p><strong>Problem:</strong> You receive a 403 Forbidden error when making an API call.</p><p><strong>Solution:</strong></p><ul><li>Verify that your access token is valid and has not expired.</li><li>Check that your app has been granted access to the API you're calling.</li><li>Ensure that you're including the correct headers in your request.</li><li>Verify that you have the necessary permissions for the operation.</li></ul><h2 id=\"environment-specific-issues\">Environment-Specific Issues</h2><h3 id=\"sandbox-environment\">Sandbox Environment</h3><p><strong>Problem:</strong> Changes made in the Sandbox environment are not reflected in Production.</p><p><strong>Solution:</strong></p><ul><li>The Sandbox environment is separate from Production.</li><li>Changes made in Sandbox do not affect Production data.</li><li>This is by design to allow safe testing without impacting production systems.</li></ul><h2 id=\"common-error-codes\">Common Error Codes</h2>\n<!--kg-card-begin: html-->\n<table>\n<thead>\n<tr>\n<th>Error Code</th>\n<th>Description</th>\n<th>Solution</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>400</td>\n<td>Bad Request</td>\n<td>Check your request format and parameters</td>\n</tr>\n<tr>\n<td>401</td>\n<td>Unauthorized</td>\n<td>Verify your authentication credentials</td>\n</tr>\n<tr>\n<td>403</td>\n<td>Forbidden</td>\n<td>Check your access permissions</td>\n</tr>\n<tr>\n<td>404</td>\n<td>Not Found</td>\n<td>Verify the resource URL</td>\n</tr>\n<tr>\n<td>429</td>\n<td>Too Many Requests</td>\n<td>Reduce your request rate</td>\n</tr>\n<tr>\n<td>500</td>\n<td>Internal Server Error</td>\n<td>Contact support if the issue persists</td>\n</tr>\n</tbody>\n</table>\n<!--kg-card-end: html-->\n<h2 id=\"getting-additional-help\">Getting Additional Help</h2><p>If you're still experiencing issues after trying the solutions above, visit the Support page for additional resources.</p>","publishedAt":"2026-09-30T09:36:20.000+00:00","updatedAt":"2026-09-30T09:36:20.000+00:00","audience":"external"}