How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Safe

Idempotency & Reliability obsoleted

A reference entry. The registry facts and catalog measurements below are complete; the written guidance for this header has not been authored yet.

The Safe HTTP header — idempotency & reliability, RFC 2310, not observed in the catalog.

Safe is idempotency & reliability — Headers that make a retry safe. Almost entirely a payments-industry invention that the rest of the API economy has not adopted.

The registry

Listed in the IANA HTTP Field Name Registry as marked obsoleted in the registry — it should not appear in new work. Defined in RFC 2310: The Safe Response Header Field.

In the catalog

Registered with IANA and declared by not one of the 26,641 providers in the API Evangelist catalog. A registered field with no observed use is still part of the vocabulary — it just is not part of the practice.

Governed by these rules

Machine-enforceable governance rules from rules.apievangelist.com that apply to this header when it appears in an OpenAPI.

OpenAPI Components Headers Error error

Utilizing the headers object in the centralized OpenAPI components library helps make headers reusable across API requests and responses

Guidance: Rate Limits →
OpenAPI Components Headers Info info

Utilizing the headers object in the centralized OpenAPI components library helps make headers reusable across API requests and responses

Guidance: Rate Limits →
OpenAPI Headers Hyphenated Pascal Case error

HTTP headers should follow Hyphenated-Pascal-Case naming convention for consistency and readability, such as Content-Type, X-Request-Id, or Accept-Language.

Guidance: Naming →