feat: document expires_at for Avatar Decoration Data

[ijsbol]

No description provided.

[markmandel]

Apologies for the delay, was OOO for the week. Thanks for the submission!

I'm just checking internally if this is something we want to document, or if it's something that may not be stable.

[markmandel]

Apologies for the delay.

Since this isn't in our Open API Spec, it's not to be documented or relied on as stable.

So I'm going to close this PR for now. If there is a strong use case for this particular field to be made stable, please file an issue and we will route the feedback internally.

Nevertheless - appreciate your contributions!

[ijsbol]

Since this isn't in our Open API Spec, it's not to be documented or relied on as stable.

It was my understanding that the Open API Spec is currently unstable and non-complete. I fail to see how something being undocumented within an incomplete specification is grounds to further leave it undocumented within what is supposed to be the complete specification.

re: README.md on the OpenAPI Spec Repo:

⚠️ The public preview of the OpenAPI spec is subject to breaking changes without advance notice, and should not be used within production environments.

[markmandel]

Totally understand the confusion -- broadly speaking, if it's not in the OpenAPI spec, it's a pretty strong indicator it's not something that we want to be publicly referencable (i.e. it might go away in the future, or change).

That being said - quadruple checking with the team who implemented the API to make extra sure, and like I said, if you strongly feel like the API field is useful, please do file an issue!

[markmandel]

FYI - super-double-quadruple checked with the team, and yes, this should not be documented at this time 👍🏻