Required Elements for Creating a Publication

To create a publication using the Thinkeo API, you'll need several key elements that must be created and identified beforehand, either through the API or the platform interface.

Prerequisites Overview

A valid bearer token for the Team owning the App

A pre-configured Thinkeo App set up for non-wizard operation

The target App ID

The App version number

IDs of the attributes you plan to use

IDs of the blocks whose content you need to retrieve

Bearer Token

This is the authentication token created in the previous step of this guide. Ensure its expiration date aligns with your needs.

Pre-configured Thinkeo App

When using a Thinkeo App via API, it won't follow the typical wizard-style progression. Instead, it executes the parent block containing all other blocks, and child blocks are executed from bottom to top in the hierarchy.

Understanding block nesting is crucial to ensure the execution order meets your expectations. Your App's block hierarchy should enable a "natural" execution flow.

For more detailed information about block execution, please refer to this documentation.

App ID

This is the App's UUID used for identification. You can find this ID in the API panel of the Studio.

Navigate to Apps, select your target App, and click on the API tab.

Version Number

Thinkeo Apps are versioned upon deployment, making them accessible to users on the platform. On the platform users always access the latest published version, while Architects work on a "preview" version.

The preview version allows immediate testing of configurations and modifications without publishing, thus preserving the production version.

The "latest" version is API-specific, always pointing to the most recent published version of the App - this is our recommended option. However, for production Apps requiring a specific version, you can specify it as a parameter.

Version types:

Preview: Use for API configuration, testing, and setup - reserved for Architects

Latest: Recommended for API implementation, whether for automation or business tool integration

Version x.x: For cases where specific versions must be validated by business teams or IT department before automation/integration updates. When manually specifying the version, use only the number without the "v" prefix.

Attribute IDs

Attributes allow you to send files and data to Thinkeo for use in your App.

Find attribute IDs in the Attributes page, and select the attribute.

Block IDs

In the studio, by selecting a block from the hierarchy or the central panel, click on the icon corresponding to the block settings.

From there you will have access to the block ID, which can also be copied/pasted with one click.

To do this, click on the "…" of a block from the tree view, select "open in new tab" then retrieve the ID.

Required Elements for Creating a Publication

Prerequisites Overview#

Bearer Token#

Pre-configured Thinkeo App#

App ID#

Version Number#

Attribute IDs#