Upsert target is not an upsert

[Sharparam]

Is there an existing issue for this?

• I have searched the existing issues

Kong version ($ kong version)

Kong 3.6.1

Current Behavior

Calling PUT /upstreams/{upstreamName}/targets/{target} returns 404 even though documentation says it is an upsert operation.

Expected Behavior

Calling the PUT endpoint should create the target if it does not exist.

(Creating a target with a POST request and then updating it with PUT works.)

Steps To Reproduce

1. Create an upstream.
2. Use the PUT API to upsert a target to it.

Anything else?

No response

[bungle]

Looks to be same as update:
https://github.com/Kong/kong/blob/master/kong/api/routes/upstreams.lua#L216-L221

Not sure, but this may be because of historical purposes. But doc seems be then wrong. One of them is wrong.

[bungle]

I discussed this with @locao, and it looks like it is a bug (in code).

[chronolaw]

@bungle , do we have a ticket to track it?

[samugi]

--> KAG-4475