Authentication

Token Creation Process

Authentication with the Thinkeo API is done using bearer tokens.
It is possible to create authentication tokens from the API or the platform.
The simplest method is to create and manage your tokens directly from the Thinkeo platform. This is only possible as a Administrator, while Architects can use tokens already created on the Team.

You can navigate to the "Team" menu then the "API" tab and from there create a token with:

A name

A permission scope (all rights or only generate publications)

An expiration date

From here you can copy an existing token or revoke it at any time.

Token creation process with API

You can also create tokens or copy existing tokens from the "API" tab in the Studio when you configure your App.

The process involves two steps to obtain a permanent token for your team.

1. Identify Your Team

List the Teams accessible with your account using Basic Auth and your Thinkeo credentials. From the response, you'll need to retrieve the ID of the Team for which you want to create your permanent bearer token.

Make a GET request to /teams:

Example response:

[
    {
        "id": "018eebbd-c47a-7d2c-a315-9f8c2e41b6d3",
        "name": "Team A",
        "stripeCustomerId": null,
        "aiConfig": null
    },
    {
        "id": "019010b5-e189-7f5d-b423-a0d7f5623c9e",
        "name": "Team B",
        "stripeCustomerId": null,
        "aiConfig": null
    }
]

Note down the ID of your desired Team for the next step.

2. Create Permanent Token

Finally, create a permanent bearer token for your Team. Make sure to specify the teamId and set an expiration date that suits your needs.

Make a POST request to /tokens:

Example response:

{
    "id": "018eebbd-f94b-7a68-c531-b2e9d7f84a0f",
    "teamId": "018eebbd-c47a-7d2c-a315-9f8c2e41b6d3",
    "name": "token_teamA",
    "expiration": "2024-09-07T00:00:00Z",
    "createdAt": "2024-09-06T11:01:53.241234399Z",
    "token": "tkak_qRXm9bNfLJTVUWoYzp15-3HKQSFD-nZxwEMCyAueghPiBcOlr_G7Jtv-TaLkdIjfw"
}

The "token" field in the response contains your permanent bearer token. You can use this token to authenticate all API requests for your Team's Apps until it expires.

Important: Store this token securely, as it provides access to all your Team's resources.

Token Creation Process#

Token creation process with API#

1. Identify Your Team#

2. Create Permanent Token#

Token Creation Process

Token creation process with API

1. Identify Your Team

2. Create Permanent Token