sungwy commented on code in PR #12376: URL: https://github.com/apache/iceberg/pull/12376#discussion_r1974643193
########## open-api/rest-catalog-open-api.yaml: ########## @@ -4566,7 +4568,9 @@ components: AuthenticationTimeoutResponse: description: - Credentials have timed out. If possible, the client should refresh credentials and retry. + This is an optional status response type that the REST Catalog can issue when the + token has expired. The client MAY request a new access token and retry the request. + 401 UnauthorizedResponse SHOULD be preferred over this response type on token expiry. Review Comment: > To retry or not is the client side decision Yes I agree with you. Although I think it'll be confusing for application developers if for example, PyIceberg removed retry handling for 419 status on the next version after the 419 status code is deprecated on the REST Catalog. The application developer would expect 419 status codes from their REST Catalog server to result in retries, and on version upgrade they their PyIceberg application no longer will. Hence, as a community, we may need to keep 419 status code handling for backward compatibility. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org For additional commands, e-mail: issues-h...@iceberg.apache.org