Think about what the client code looks like to handle this and the alternative, particularly if you’re implementing an sdk and the api is an implementation deta

Think about what the client code looks like to handle this and the alternative, particularly if you’re implementing an sdk and the api is an implementation detail. I’m not saying I would choose this path, but it certainly reduces the amount of code on both sides that you have to write.