v3.23.1

Getting Started Devices Gateways Integrations Reference
Get The Things Stack

Reference

    Overview
  • Adaptive Data Rate
  • API
  • Application Packages
  • Billing with Stripe
  • Command-Line Interface
  • Components
  • Configuration
  • Data Formats
  • Data Retention and Privacy
  • Email Templates
  • Federated Authentication
  • Frequency Plans
  • FUOTA
  • Gateway RTT
  • Glossary
  • ID and EUI Constraints
  • Last Activity
  • LoRa Basics Station Implementation Guide
  • LoRaWAN Backend Interfaces Interoperability
  • LoRaWAN Specification and Regional Parameters
  • Networking
  • Packet Broker Routing
  • Packet Forwarders
  • Purging Entities
  • Rate Limiting
  • Resource Limiting
  • Root Certificates
  • Telemetry
  • Tenant Management
  • Web UI Branding

ID and EUI Constraints

This reference explains how The Things Stack deals with IDs and EUIs, including regular expression requirements, uniqueness, and how deletion is handled.

Requirements of an ID or EUI

An ID or EUI in The Things Stack must:

  • Have a length of between 3 and 36 characters (inclusive)
    • Exception: User IDs can have a length between 2 and 36 characters (inclusive)
  • Consist of lowercase letters, numbers, and non-consecutive dashes
  • NOT begin or end with a dash

The following regular expression is used to validate IDs and EUIs (with the exception of the User ID):

(^[a-z0-9](?:[-]?[a-z0-9]){2,}$)

Uniqueness

Within a deployment, there can only be:

  • One tenant with the same ID
  • One gateway with the same EUI (across all tenants)
  • One end device with the same combination of DevEUI and JoinEUI (across all tenants)

Within a tenant, there can only be:

  • One user or organization with the same ID
  • One application with the same ID
  • One gateway with the same ID
  • One OAuth client with the same ID

Within an application, there can only be:

  • One end device with the same ID

Deleted Entities

When deleting entities, some IDs are retained so that they can’t be registered again. This is for security reasons as integrations may store historical data by ID, and you don’t want that someone else can register an ID and get your historical data.

EUIs of gateways and end device are released when deleted.

  • When a user or organization is deleted, the ID is retained and cannot be reused within the tenant
  • When an application is deleted, the ID is retained and cannot be reused within the tenant
  • When a gateway is deleted, the ID is retained but the gateway EUI can be reused
  • When an end device is deleted, the ID and EUI are released and can be reused
Note:
Entity IDs that were purged from an admin account are released and can be reused. Also, keep in mind that The Things Stack allows you to restore deleted entities within 24 hours from the time when they were deleted.
← Glossary Last Activity →

On this page

  • Requirements of an ID or EUI
  • Uniqueness
  • Deleted Entities

The Things Stack

Getting Started

Devices

Gateways

Integrations

Reference

Contributing

GitHub

Forum

About Us

The Things Network

The Things Industries

About this page

Last changed by Nejra Selimović on 26 Nov 2022.
doc: Notes on using IDs after purge (#1001)

Edit on Github