SA.Automate.Brickset 1.0.0

SA.Automate.Brickset

Brickset connection types and actions for Umbraco Automate. Look up and search LEGO sets as part of an automation workflow.

What is Brickset?

Brickset is a database of LEGO sets, providing details such as pieces, minifigs, theme, pricing, and images, looked up by set number or free-text search.

What can this be used for?

This package is useful when you want LEGO set data inside an Umbraco Automate workflow, for example:

• Enriching content: pull set details (name, image, piece count) into content as part of an automation.
• Conditional content: branch a workflow based on a set's theme, year, or availability.
• Logging/reporting: record set data alongside other workflow data.

Installation

dotnet add package SA.Automate.Brickset

No further setup required. The composer registers itself automatically via Umbraco's IComposer discovery.

Connection types

This package registers a single Brickset connection type:

• API Key: required. The Brickset API key used by this connection.

Setup

1. Get an API key

Get an API key from brickset.com.

2. Store the key in appsettings.json (optional)

The connection's API Key field is marked sensitive, so instead of entering the key directly in the backoffice you can store it in appsettings.json and reference it using Umbraco Automate's configuration reference syntax:

{
  "Umbraco": {
    "Automate": {
      "Secrets": {
        "BricksetApiKey": "your-api-key"
      }
    }
  }
}

The API Key field already defaults to $Umbraco:Automate:Secrets:BricksetApiKey, so once this is set you can leave the field as-is when creating the connection below — no need to paste the reference in manually.

3. Create the connection in the backoffice

1. Go to Automate → Connections and create a new Brickset connection.
2. Give the connection a name and enter your API Key — either the key itself, or, if you stored it in appsettings.json above, the reference $Umbraco:Automate:Secrets:BricksetApiKey (the field's default value).
3. Click Test connection to verify. This requests a well-known set to confirm the API key is valid.

Usage

Get Set By Number

Add the Get Set By Number action to any automation and select the connection to use. Available fields:

The action outputs the following, which can be referenced via bindings in later workflow steps:

Search Sets

Add the Search Sets action to any automation and select the connection to use. Available fields:

The action outputs the following, which can be referenced via bindings in later workflow steps:

Compatibility

Links

• Source code
• Report an issue
• Brickset API documentation