---
title: Troubleshoot
slug: commerce-connect-14/docs/troubleshoot
docTags: 
createdAt: 2026-07-23T10:25:32.999Z
---

The following are ways to resolve issues you may see while using Agent Platform tools with Optimizely Commerce Connect.

## "Authorization failed" (401)

- Ensure your Opti ID token is valid and not expired.
- Check that the token includes the required scopes.
- Verify the authorization header format: `Bearer <token>`.

## "Campaign/Promotion not found" (404)

- Verify the identifier is correct (name or ContentReference ID).
- Use `campaign_filter` or `promotion_filter` to search for the correct resource.

## "Content Graph query failed"

- Verify the Content Graph configuration in `appsettings.json`.
- Check that `GatewayAddress`, `AppKey`, and `Secret` are correct.
- Use `com_graph_schema` to verify the schema structure.

## "Property path not found" in dynamic update

- Use `promotion_properties` to get valid property paths.
- Verify that property paths use underscore notation (such as `Condition_RequiredQuantity`).
- Ensure the property exists on the specific promotion type.

## "ValidUntil must be greater than ValidFrom"

- Verify the campaign end date is after the start date.
- Check the date format (ISO 8601).

## Get help

For additional assistance, see the following:

- Check the [GitHub repository](https://github.com/episerver/commerce-opal-tools).
- Review the `CLAUDE.md` file for implementation details.
- Contact [Optimizely Support](https://support.optimizely.com/hc/en-us) for product-specific questions.