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 your browser's URL when accessing the platform.

Navigate to Apps, select your target App, and the App editor will open. The App ID can be found in the page URL.

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. Hover over a row to reveal a copy icon for easy ID copying.

Block IDs

To obtain a block's UUID, open it in a new tab and find the ID in the browser URL.

Example: thinkeo.io/block/0191eabd-48cb-7de1-9e2c-ae53281cf173

To access this, click the "..." menu on a block in the hierarchy, select "open in new tab," and copy the ID.

Required Elements for Creating a Publication

Prerequisites Overview#

Bearer Token#

Pre-configured Thinkeo App#

App ID#

Version Number#

Attribute IDs#