---
title: Troubleshoot Agent Platform tools
slug: commerce-connect-15/docs/troubleshoot-agent-platform-tools
docTags: 
createdAt: 2026-07-30T20:34:42.000Z
---

The following sections describe common issues with Optimizely Agent Platform tools in Optimizely Commerce Connect and how to resolve them.

## 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 or 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).
- Contact [Optimizely Support](https://support.optimizely.com/hc/en-us) for product-specific questions.
