Skip to main content

Generating ULIDs

Every Custom API definition requires a unique feature_id in ULID format. Generate a new one for each definition you create — never reuse an existing feature_id.

The other IDs (org_id, project_id, space_id, user_id) come from your existing org and project setup — only feature_id needs to be generated fresh each time.

What Is a ULID?​

A ULID is a 26-character, uppercase, alphanumeric identifier that is:

  • Time-sortable — first 10 characters encode the timestamp
  • URL-safe — no special characters
  • Globally unique — safe to generate anywhere without a central registry
01KBY3K8RQ9GS1VD9XYXHZ92QT

Generating a ULID​

JavaScript / Node​

npm install ulid
import { ulid } from 'ulid';

const featureId = ulid();
console.log(featureId); // 01KBY3K8RQ9GS1VD9XYXHZ92QT

Python​

pip install python-ulid
from ulid import ULID

feature_id = str(ULID())
print(feature_id)  # 01KBY3K8RQ9GS1VD9XYXHZ92QT

curl (online generator)​

curl https://ulid.truestamp.com/

Online​

Generate one instantly at ulidgenerator.com.

In Your Definition​

Replace feature_id with your newly generated ULID every time you create a new definition:

identifiers:
  org_id: 01KC11784DW133S3THR7JTQNQ1       # from your org
  project_id: 01KC11KZ6VDMMKJZ4YWQYKYZ6Z   # from your project
  feature_id: 01KBY3K8RQ9GS1VD9XYXHZ92QT   # ← generate a new one each time
  space_id: 01KBY3K97GMAJFBQ0PP7158NZH      # from your space
  user_id: 01KBY3K9NDC5XW523M2V1Z0373       # your user ID
caution

Reusing a feature_id will overwrite the existing definition with that ID. Always generate a fresh ULID for new definitions.