REST Catalog: Return LoadTableResult for successful update requests

[Tishj]

Feature Request / Improvement

For the endpoints:

• POST /v1/{prefix}/tables/rename
• POST /v1/{prefix}/transactions/commit

Currently, on success, both these endpoints return:

      responses:
        204:
          description: Success, no content

I would like to request a change for these endpoints to return the updated metadata on success, as this could save an additional roundtrip to fetch the new state for future updates/scans.

Confusingly, the POST /v1/{prefix}/namespaces/{namespace}/tables/{table} endpoint already does this:

      responses:
        200:
          $ref: '#/components/responses/CommitTableResponse'

Which contains an updated TableMetadata object

Query engine

None

Willingness to contribute

• I can contribute this improvement/feature independently
• I would be willing to contribute this improvement/feature with guidance from the Iceberg community
• I cannot contribute this improvement/feature at this time

[nastra]

Introducing this to the API would mean introducing breaking changes across the Catalog API and to the REST specification, so this isn't realistically achievable. The reason why these endpoints behave that way is due to the Catalog API, which doesn't have any return types defined