Re: Proposed Public OpenAPI Changes

2025-09-08 Thread Yufei Gu
Thanks for the proposal, Adnan. Returning representations from the create endpoints makes sense to me and will reduce a follow-up GET in most clients. For addGrantToCatalogRole, the grant itself is more a relationship between entities than entity itself. I understand it returns 201(Created) now,

Re: Proposed Public OpenAPI Changes

2025-09-08 Thread Alexandre Dutra
Hi Adnan, Thanks for bringing this topic to our attention. In general, for operations creating new resources, the event instrumentation logic could rely on the incoming request. E.g. for createCatalog, if the response does not contain the catalog resource, it is generally OK to grab it from the i

Proposed Public OpenAPI Changes

2025-09-05 Thread Adnan Hemani
Hi all, While instrumenting event generation for all APIs, I found multiple public APIs which I would like to request a change to in order to better support event instrumentation as little-to-no cost to performance and/or bytes sent in a response. createCatalog This API currently returns (on