Building Blocks for HTTP APIs Working Group

This is the home page of the IETF Building Blocks for HTTP APIs (HTTPAPI) Working Group.

See our:

Current and Upcoming Work [Updated July 2024]

The group is currently working on the following specifications (in the GitHub repository indicated). The step in the progress graph with an orange circle represents the current state of the document. The pink colour indicates the status at the last IETF meeting :

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt --draft-02--> WGLC
    WGLC --> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IANA-Review
    IANA-Review --> IESG-Review((IESG-Review))
    IETF-LC --draft-03--> IESG-Review
    IESG-Review --draft-04--> RFC-Editor
    RFC-Editor --> RFC   

    class IESG-Review lastIETF
    class RFC-Editor current

The Deprecation HTTP Header Field - repository

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt((WG Adopt)) --draft-03--> WGLC
    WGLC --> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --draft-04--> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC

    class IESG-Review current
    class WG-Adopt lastIETF 

API Catalog

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt((WG Adopt)) --draft-00-02--> WGLC
    WGLC --draft-03--> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC

    class WG-Adopt lastIETF
    class WGLC current

The Idempotency-Key HTTP Header Field - repository

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt((WG Adopt)) --draft-05--> WGLC
    WGLC --> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC

    class WG-Adopt current

RateLimit Fields for HTTP - repository

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt((WG Adopt)) --draft-07--> WGLC
    class WG-Adopt current
    WGLC --> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC

REST API Media Types - repository

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt((WG Adopt)) --draft-05--> WGLC
    class WG-Adopt current
    WGLC --> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC

Byte Range Patch

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt((WG Adopt)) --draft-01--> WGLC
    class WG-Adopt current
    WGLC --> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC
graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt((WG Adopt)) --draft-00--> WGLC
    class WG-Adopt current
    WGLC --> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC
graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt((WG Adopt)) --draft-00-01--> WGLC
    class WG-Adopt current
    WGLC --> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC

Completed Work

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt -- draft-00-06 --> WGLC
    WGLC --> AD-Review
    AD-Review -- draft-06-08 --> IANA-Review
    IANA-Review --draft-09--> IETF-LC
    IETF-LC --draft-10--> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --> RFC((RFC9624))
    class RFC current

Problem Details for HTTP APIs - repository

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt --draft-03--> WGLC
    WGLC --draft-04--> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IANA-Review 
    IETF-LC --draft-06--> IESG-Review   
    IANA-Review --draft-04--> IESG-Review
    IESG-Review --draft-07--> RFC-Editor
    RFC-Editor --> RFC((RFC 9457)) 

    class RFC current

YAML Media Type - repository

graph LR
    classDef current fill:orange
    classDef lastIETF fill:pink

    WG-Adopt --draft-03--> WGLC
    WGLC --draft-04--> AD-Review
    AD-Review --> IETF-LC
    IETF-LC --> IESG-Review
    IETF-LC --> IANA-Review
    IANA-Review --> IESG-Review
    IESG-Review --> RFC-Editor
    RFC-Editor --draft-09-10--> RFC9512((RFC 9512))
    
    class RFC-Editor lastIETF
    class RFC9512 current

See also the official document listing.

We talk about potential future work on the mailing list and in the discussion repo.

Who Should Participate

We think that the following sorts of people will be able to effectively contribute to this work:

Others are, of course, welcome to join.

How to Participate

Everyone who participates needs to understand the IETF NOTE WELL conditions. This includes the Intellectual Property terms, code of conduct, and other important policies.

If you plan on actively participating, subscribing to the working group mailing list is encouraged but not required.

Anyone can make comments or pull requests to the specification repositories (see above).