Content Fetch action

Reads one piece of content from a connected Brightspot CMS—by content id, or by a field the type uses as a unique key such as a slug or an external id. In the action picker it is Content Fetch, under Integration Actions.

Fields

Field	Required	Description
Connection	Yes	The Brightspot connection to read from.
Lookup Field	No	The field to match on. Leave it blank to fetch by content id; name an indexed unique field—a slug, an external id—to fetch by that instead.
Lookup Value	Yes	The value the lookup field must equal—a content id when Lookup Field is blank.
Content Type	No	Required for any lookup field other than the content id. Optional when fetching by id, where it narrows the fetch: content of any other type reports as not found.

There is one addressing here, not two. The content id is a field like any other, so fetching by id is this step with Lookup Field left blank. Only the content id is unique across every type, which is why anything else needs a Content Type to search within.

Output

found, plus contentId, contentTypeId, contentTypeName, label and contentValues when something matched. Nothing matched leaves those absent rather than empty, so check found first.

Finding nothing by field is a normal result, not a failure. The step completes with found set to false, so a later step can create what was missing. Fetching by id is different—an id names content that is supposed to be there, so nothing at it fails the step.

Matching more than one record fails. The field is being used as a key, and picking one of several would act on an arbitrary record. Use the Content Query action when you want every match rather than exactly one.

Upserting without a branch

1. Content Fetch the article whose slug is the one you have.
2. A Content Script builds from payload.contentValues when payload.found, and from scratch when it doesn't.
3. A Content action Save with a Content Type and Create If Missing, and no target.

No condition, no two paths to keep in step: the same three nodes cover content that exists and content that doesn't.