Docs
Plugin HubCategoriesTraffic ManagementRequest IDChangelog

Request ID Changelog

Released changes to the Request ID plugin (`request-id`), newest release first.

21 released changes name request-id, newest release first — 11 in Apache APISIX, 10 in API7 Gateway. Each row links to the change itself.

Apache APISIX

ReleaseDateTypeChange
3.18.02026-08-18FixGenerate nanoid with a CSPRNG to avoid duplicate and malformed ids
3.17.02026-06-11FeatureAdd UUID v7 generation support
3.15.02026-02-02FixAdding request-id header in case of empty header value in request
3.15.02026-02-02FeatureSupport apisix_request_id variable with request-id plugin
3.14.02025-10-09FeatureAdd ksuid algorithm on request-id plugin
3.5.02023-08-29ChangeRemove snowflake algorithm in the request-id plugin
3.2.02023-03-06FixWhen hotloading plugins, redundant timers may be left behind if the request-id plugin initializes the snowflake generator incorrectly
2.15.02022-07-22FixAdjust the execution priority of request-id so the tracing plugins can use the request id
2.14.0—FeatureThe request-id plugin adds nanoid algorithm to generate ID
2.9.02021-08-24FeatureRequest-ID plugin add snowflake algorithm
2.8.02021-07-26FixWe can use different ids with the same request

API7 Gateway

ReleaseDateTypeChange
3.10.3 (opens in API7 Gateway docs)2026-07-14FixFixed issue: Configuring algorithm: range_id without the optional range object could return HTTP 500. The range object now has a default value. (opens in API7 Gateway docs)
3.10.1 (opens in API7 Gateway docs)2026-06-15FixFixed issue: With algorithm set to nanoid, the generator produced a high rate of duplicate and malformed IDs and leaked a file descriptor per ID. It is replaced with a CSPRNG-based generator; the ID format is unchange… (opens in API7 Gateway docs)
3.9.16 (opens in API7 Gateway docs)2026-07-10FixFixed issue: Configuring algorithm: range_id without the optional range object could return HTTP 500. The range object now has a default value. (opens in API7 Gateway docs)
3.9.14 (opens in API7 Gateway docs)2026-06-15FixFixed issue: The nanoid algorithm could produce duplicate or malformed IDs. IDs are now generated with a cryptographically secure random source and always use the valid nanoid alphabet. (opens in API7 Gateway docs)
3.9.8 (opens in API7 Gateway docs)2026-04-07FeatureAdded uuidv7 as a new algorithm option. UUID v7 generates time-ordered, lexicographically sortable unique identifiers, making them more suitable for distributed tracing and log correlation than random UUID v4. (opens in API7 Gateway docs)
3.9.2 (opens in API7 Gateway docs)2026-01-19FixFixed issue: The system failed to generate a new request ID when the request-id provided by the client was empty. (opens in API7 Gateway docs)
3.9.0 (opens in API7 Gateway docs)2026-01-06FeatureAdded a new algorithm ksuid for ID generation. (opens in API7 Gateway docs)
3.8.22 (opens in API7 Gateway docs)2026-01-19FixFixed issue: The system failed to generate a new request ID when the request-id provided by the client was empty. (opens in API7 Gateway docs)
3.8.1 (opens in API7 Gateway docs)2025-05-07FixRemoved the snowflake algorithm from the request-id plugin due to potential risks. (opens in API7 Gateway docs)
3.7.4 (opens in API7 Gateway docs)2025-04-30FixRemoved the snowflake algorithm from the request-id plugin due to potential risks. (opens in API7 Gateway docs)

Configuration

Previous Page

Request Validation

Next Page