ids (Filter IDs)

1 min

The ids parameter lets you fetch a known set of content items by exact GUID match in Optimizely Graph, which is the fastest way to retrieve a specific item or a small, fixed list of items without writing a broader where filter. Use it when an application already holds the content GUIDs (for example, IDs persisted in a CMS reference field) and needs to project the latest field values.

The ids parameter lets you filter globally unique identifiers (GUIDs) through the ContentLink.GuidValue property. This parameter is an array of GUIDs.

Request example

The following request retrieves a single BiographyPage item by its GUID and projects the Name and ContentLink.GuidValue fields.

{
  BiographyPage (
    locale: en,
    ids: ["64ea99b4-fe38-43b7-a993-20ceb333861a"]
  )
  {
    Name,
    ContentLink{GuidValue}
  }
}