How to combine the 4 of 5 responses as a $ref?

[Yao544303]

Hi. I am draft the API specification. Here is my question?
For each API, there are 5 responses, such as

...
"responses":{
   "200":{
       // the 200 responses if different for each API
   },
   "400":{
      "$ref": "#/components/schemas/Error400"
   },
   "401":{
      "$ref": "#/components/schemas/Error401"
   },
   "404":{
      "$ref": "#/components/schemas/Error404"
   },
   "429":{
      "$ref": "#/components/schemas/Error429"
   }
}
...

Since the 200 is different for each API with different response schema, but the 400-429 is same. May I combine 400-429 into one $ref?
Such as

"responses":{
   "200":{
       // the 200 responses if different for each API
   },
  "4xx":{
      "$ref":"xxx"
  }
}
...

[lornajane]

In OpenAPI, we don't have this feature, but you could use an Overlay to add the group as a separate step. There's a similar-ish example in the Overlays docs but please let us know if you need more context on what this is and how to do it?

[Yao544303]

This is great! Thank you.

[handrews]

See also:

• Compose all component types, not just schemas #2936

[Montiwa11]

Ok thank you