# Versions

The Trusted Twin API changelog lists changes to the Trusted Twin API.

# 3.16.00 (04-06-2024)

You can now grant and remove access to your account's notification topics to foreign accounts:
- update_notifications_account_access
You can now retrieve a list of accounts that have access to your account's notification topics:
- get_notifications_access
You can now use templates in the "publish" property of a Sticker (see the list of templates available for Stickers in the Templates section).
You can now add more than one topic in the "publish" property for a given Sticker event ("on_put", "on_remove", "on_expire").

# 3.15.00 (09-05-2024)

Minor improvements to the Usage functionality.

# 3.14.00 (15-04-2024)

Changes to the resolve_twin_identity endpoint:
- the "context" query string parameter now takes also a list of account UUIDs as value.
Changes to the get_stickers endpoint:
- the "context" query string parameter now takes also a list of account UUIDs as value.
Minor fixes to the get_twin_identities endpoint.

# 3.13.01 (27-03-2024)

Minor fixes to the role functionality.
Minor fixes to the user functionality.
Minor fixes to the batches functionality.

# 3.13.00 (14-03-2024)

Added the following endpoint to the Database advanced services category:
- update_database_ip_access.
Improvements to the get_batches endpoint:
- you can now use the ge, le, limit and cursor parameters when listing batches.

# 3.12.00 (07-02-2024)

Changes to the "write" permission in databases:
- the "write" permission does not include the "read" permission. If you had "write" permissions set for your database, these have been changed to ["read", "write"] to preserve the permission levels.
Improvements to the advanced services (Timeseries and Indexes):
- You can add more than one database to a single account.
Added the Database advanced services category and the following endpoints:
Minor changes to the create_timeseries_table endpoint:
- When creating a Timeseries table, you need to define which database it should be created in. In other case, the Timeseries table will be created in the default database.
Minor changes to the create_indexes_table endpoint:
- When creating an Indexes table, you need to define which database it should be created in. In other case, the Indexes table will be created in the default database.
Minor changes to the get_timeseries_tables endpoint:
- The "status", "database_size", and "database_uuid" attributes are no longer available in the response to the get_timeseries_tables endpoint. These attributes are available in the response to the get_database for the given endpoint.
- The "users" property is no longer available in the response to the get_timeseries_tables endpoint. All information related to database access is available through the get_database_access endpoint
Minor changes to the get_indexes_tables endpoint:
- The "status", "database_size", and "database_uuid" attributes are no longer available in the response to the get_indexes_tables endpoint. These attributes are available in the response to the get_database for the given endpoint.
- The "users" property is no longer available in the response to the get_timeseries_tables endpoint. All information related to database access is available through the get_database_access endpoint. Minor changes to the "database_uuid" attribute:
- the name of the "database_uuid" attribute is now "uuid".
Minor improvements to the Stickers functionality:
- the "note" maximum length is now 1024 characters (extended from 512 characters).

# 3.11.00 (10-01-2024)

Added the "details" query string parameter to the resolve_twin_identity endpoint.
Added the "auth_type" and "cause" variables to rules.
Changed the "auth_type" values from "USR" and "TKN" to "secret" and "token".

# 3.10.00 (20-12-2023)

Added the Resource Access Log functionality.
Added endpoints allowing to retrieve and update the configuration of the account of the calling user:
- get_account
- update_account

# 3.09.00 (15-11-2023)

Improvements to the Stickers functionality.
Minor fixes to the Identity functionality.

# 3.08.00 (2-11-2023)

Added the "operation" variable to rules.
Minor improvements to the scan_twins functionality.

# 3.07.00 (19-10-2023)

Improvements to advanced database services (Timeseries, Indexes):
- When inserting records, when a match is found on a timestamp and in dimensions columns in an existing record, the existing record is updated with new measurement values instead of inserting a new one.
Fixes to advanced database services (Timeseries, Indexes).
New built-in functions in rules.
Improvements to existing built-in functions in rules.
Minor improvements to the scan_twins functionality.

# 3.06.00 (20-9-2023)

Minor improvements to the batch functionality.
Minor improvement to the role and user objects.

# 3.05.00 (6-09-2023)

Added the batch functionality and the following endpoints:
Minor improvements to the role and user objects.

# 3.04.00 (10-08-2023)

Minor system improvements.

# 3.03.00 (12-07-2023)

Added the scan_twins endpoint.
Minor improvements to the Timeseries service.

# 3.02.00 (26-06-2023)

Added the "activity" field to the user object. The "activity" field lets you enable the User Activity Log for a given user.
Minor improvements to the Doc object.
Minor improvements to the History service.
Minor fixes to the role object.

# 3.01.00 (15-06-2023)

Improvement to the Notifications service:
- you can now set notifications events to be triggered upon deletion of a Ledger Entry.
Minor changes to the Notifications service:
- the "topic" value must match the regular expression(opens new window) ^[0-9A-Za-z\\-]{3,48}$.
Minor changes to the Stickers service:
- "color" value must the regular expression(opens new window) ^[0-9A-Za-z\\-]{3,48}$.
Minor improvements to the Stickers functionality.
Minor fixes to the Notifications functionality.

# 3.00.01 (13-04-2023)

Minor improvements to the Notifications service.

# 3.00.00 (03-04-2023)

Added built-in functions.
Changes to the Ledger object:
- the "entry_created_ts", "entry_updated_ts" and "value_changed_ts" are now only available at the Entry level,
- the "history", "timeseries", "publish", and "value" attributes are returned only if they have a value.
Minor improvements to the Notifications and Stickers services.
Minor changes to the role object.

# 2.13.00 (20-01-2023)

Added the get_users endpoint.
Added the get_twin_ledger_entry_value endpoint.

# 2.12.00 (22-12-2022)

Added the Notifications functionality to the Stickers service.<
Added the "geography" and "geometry" types for the "properties" column in the Indexes service and for the "measurement" column in the Timeseries service.
Minor changes to the Indexes service.
Minor changes to the Timeseries service.
Minor changes to the Ledger Entry.
Minor improvements to the get_twin_ledger_entry_history endpoint.

# 2.11.00 (8-12-2022)

Minor system improvements.

# 2.10.00 (21-11-2022)

Added the "identity" field to role rules.
Minor fixes to the User Token functionality.

# 2.09.00 (10-11-2022)

Improvements to update_twin_ledger_entry:
- you can now update the "history", "publish", and "timeseries" attributes. Minor improvements to the History service:
- if "history" attribute is set to null (through add_twin_ledger_entry and update_twin_ledger_entry endpoint), the History service is not enabled.
Minor improvements to the Notifications service:
- if not provided, the default value of the "expires" parameter is 604800 seconds (7 days).

# 2.08.00 (20-10-2022)

Added the update_twin_ledger_entry_value endpoint.
Minor improvements to the Timeseries database.
Minor fixes to the Notifications service.

# 2.07.00 (13-10-2022)

Added the Stickers service and the following endpoints:
Added the User Token functionality and the following endpoints:
- create_user_token
- refresh_user_token
Added Trace functionality and the following endpoint:
- trace
Improvements to update_timeseries_table:
- you can now update the names of the "measurements" and "dimensions" columns,
- you can now add new "measurements" and "dimensions" columns to an existing Timeseries table.
Improvements to update_indexes_table:
- you can now update the names of "properties" columns,
- you can now add new "properties" columns to an existing Indexes table,
- you can now update the templates of existing properties.
Minor improvements to the Doc object.

# 2.06.00 (15-09-2022)

Major system refactor.
Added the X-TrustedTwin custom header.
The Timeseries and Indexes databases are now also accessible through domain names (database_id.database.trustedtwin.com).

# 2.05.02 (21-07-2022)

Added the following endpoints related to usage:
- get_account_usage
- get_user_usage

# 2.05.01 (18-07-2022)

Minor fixes to the Ledger Entry.

# 2.05.00 (12-07-2022)

Added the Notifications service and the following endpoints:
Added the who_am_i endpoint.
Added the "include" field to the Ledger Entry.
Added the "timestamp" field to the Timeseries database.

# 2.04.00 (21-06-2022)

Minor fixes to the History service.

# 2.03.02 (01-06-2022)

Minor improvements to the Indexes database.

# 2.03.01 (25-05-2022)

Minor fixes to the Indexes database.

# 2.03.00 (20-05-2022)

Added the Indexes* service and the following endpoints:

The Indexes* service needs to be enabled for your account. Please contact hello@trustedtwin.com for more details.

# 2.02.00 (28-04-2022)

Added the History service and the following endpoint:
- Added the get_twin_ledger_entry_history endpoint.
Added the get_log endpoint.
Minor fixes to the Timeseries database.

# 2.01.02 (13-04-2022)

Minor fixes to the Timeseries database.

# 2.01.01 (12-04-2022)

Minor improvements to the Timeseries database.

# 2.01.00 (11-04-2022)

Added the Timeseries* database and the following endpoints:
Added the "history" and "timeseries" fields to the Ledger Entry.

The Timeseries* service needs to be enabled for your account. Please contact hello@trustedtwin.com for more details.

# 2.00.01 (06-04-2022)

Minor improvements to the Doc object.

← Advanced services Trusted Twin API →