Blog posts by Akash

Fixing index_not_found_exception After Purging External Data in Optimizely Graph

Thu, 16 Jul 2026 08:20:17 GMT

The Scenario: Indexing External Data

When working with Optimizely Content Graph, indexing external data is a straightforward process. Synchronize custom data sources with Optimizely Graph

Followed by setting up a GraphQL schema to push an external content type called Article into a specific source src1

Here is the initial schema definition using the V3 API:

curl --location --request PUT 'https://cg.optimizely.com/api/content/v3/types?id=src1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic BASE64_ENCODED_CREDENTIALS' \
--data '{  
  "languages": ["en-US"],
  "contentTypes":{
   "Article": {
     "contentType": [],
     "properties": {
       "Id": { "type": "Int" },
       "Keywords": { "type": "String", "searchable": true },
       "Language": { "type": "String" },
       "Comment": { "type": "String" },
       "Body": { "type": "String", "searchable": true },
       "Summary": { "type": "String", "searchable": true },
       "CreatedTime": { "type": "Date" }      
     }
   }
 } 
}'

After registering the schema, I successfully synced the content using Post request via a scheduled job. The data was indexed and queryable.POST /api/content/v2/data?id=src1

The Problem: A Silent Failure Post-Purge

To clean up the index and start fresh, I executed a purge operation using the API: DELETE /api/content/v2/data?id=src1

While the purge succeeded and cleared the results, a major issue occurred when my scheduled job tried to sync new data. The Post request returned a successful response with a journalId, but queries still returned zero items.

Upon checking the journal stream details in Postman I found the culprit: a failed status throwing an index_not_found_exception https://cg.optimizely.com/journal/stream/journalId

The Root Cause: Management Layer vs. Storage Layer

Why did the API return a success response if the index didn't exist? The answer lies in how Optimizely Content Graph separates data configuration:

The Management Layer (Schema Registry): When you check for your schema, the API looks at its registry. The blueprint for Article is still there, so the ingestion gateway assumes everything is fine and accepts your data stream (giving you a success response and a journalId).
The Storage Layer (Elasticsearch Cluster): This is where the physical data buckets live. When you performed the purge, it completely wiped the physical storage bucket to free up cloud resources.

When the background worker attempts to write your new data to the physical storage layer, it panics and throws the index_not_found_exception because the actual bucket no longer exists.

According to the Optimizely development team, the legacy DELETE /api/content/v2/data and the newer DELETE /api/content/v3/sources?mode=data endpoints delete all data, including the underlying indices. Because this is an external content type, the system doesn't automatically rebuild the physical container upon receiving new data.

The Current Solution

If you expect a purge to solely remove records while keeping the underlying physical container intact, you will run into this error. As the purge inherently drops the Elasticsearch index, you must manually recreate it.

To resolve this, you must re-push your schema before indexing new documents.

Purge the data: DELETE /api/content/v2/data?id=src1
Recreate the Schema: Resend your original PUT request to o rebuild the physical storage index. PUT /api/content/v3/types?id=src1
Sync the Content: Execute your Post request to index the new documents.

By pushing the schema again after every purge, you ensure the underlying Elasticsearch container is recreated and ready to accept your external content data streams.

Support the Feature Request

While the workaround above successfully resolves the issue, the ideal behavior would be for the purge operation to delete only the content records, leaving the underlying physical container and schema intact so background syncs don't fail.

I have submitted a feedback request to the Optimizely support to address this behavior. If you have run into this same issue, please upvote and support the request here:

Vote here: Sync External Content Data - Purge Deletes Content and Schema

List Properties of a Optimizely Content Type programmatically

Thu, 02 Jul 2026 08:48:45 GMT

Properties are simply fields used to create a content type in Optimizely. Lets explore how to get a list of properties of a specific content type defined in Optimizely. These properties can be simple text, rich text, images, links, etc. The blog is useful for devs aiming to map opti content type properties while migrating content.

Content

In Optimizely CMS, the first term you will hear is content. Content is just like items in Sitecore.

Content Type

The different types of content could be of type page, block, media, video, image, or a custom type.

IContentTypeRepository

To get a list of all available content types defined in Optimizely CMS project, first, we will need an instance of IContentTypeRepository, as this is the primary API for accessing the repository methods.

Through the content type repository instance, we can perform CRUD (Create, Read, Update and Delete) operations on content. Alternatively, if you only need read-only access, use the IContentLoader instance.

var repository = ServiceLocator.Current.GetInstance<IContentTypeRepository>();

The list() method lists all available content types (Block, Media, Page, Image, Video) in the repository.

var contentTypeList = repository.List();

Content type - To get the content type of block or page type, we can filter the list by passing the content type.

var pageTypes = repository.List().OfType<PageType>();

var blockTypes = repository.List().OfType<BlockType>();

By passing PageType as a parameter, we shall get all the content of the type page.

To get a specific content type, use the Load() method on the repository instance. The Load() methods have overloads, and we can get the specific content type by passing Id, Guid, ContentType, or Name as parameter.

var contentType = repository.Load<LocationItemPage>();

In solutions, which do not have a reference to the Optimizely CMS project example a razor class library project. The specific content type is not accessible, which is present in Optimizely Project. In such a scenario, we can use the Guid or Id saved in global constants file.

var contentTypeById = contentTypeRepository.Load(contentTypeId);

PropertyDefinitions

Returns a property collection containing all properties defined in a specific content type.

var properties = contentType.PropertyDefinitions;

Getting property names

We can retrieve the properties and save them in list. we can use EditCaption property for getting display names of properties. If one needs actual property names use Name property.

List Properties = new List<string>();

foreach (var property in properties)

{

string propertyName = property.EditCaption;

Properties.Add(propertyName);

}

You can further explore PropertyDefinitions class as it gives access to other properties and methods which can be of use in development.

Happy Learning!