Incorrect curl commands

[rajeevramani]

Where is the problem?

On this page https://docs.konghq.com/gateway/3.9.x/key-concepts/routes/expressions/ there is a documentation that says

Create routes with expressions

To create a new route object using expressions, send a POST request to the services endpoint:

curl --request POST \
  --url http://localhost:8001/services/example-service/routes \
  --form-string expression='http.path == "/mock"'

What is your suggestion?

The curl command is incorrect

(The service example-service has been created)

This curl command is incorrect and results in a message

{"code":2,"fields":{"expression":"unknown field","@entity":["must set one of 'methods', 'hosts', 'headers', 'paths', 'snis' when 'protocols' is 'https'"]},"message":"2 schema violations (must set one of 'methods', 'hosts', 'headers', 'paths', 'snis' when 'protocols' is 'https'; expression: unknown field)","name":"schema violation"}

Code of Conduct and Community Expectations

• I agree to follow this project's Code of Conduct
• I agree to abide by the Community Expectations

[javicps]

Actually the command is correct, but you need to satisfy the prerequisite indicated in the documentation:
Edit the kong.conf to contain the line router_flavor = expressions and restart Kong Gateway.
Without it, the expressions are not accepted in the API calls

Once router_flavor = expressions is added, the CURL command works as expected:

curl --request POST \
  --url http://localhost:8001/services/example-service/routes \
  --form-string expression='http.path == "/mock"'
HTTP/1.1 201 Created
Date: Sat, 08 Mar 2025 19:17:41 GMT
Content-Type: application/json; charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
X-Kong-Admin-Request-ID: 85d16e0f5128c955985eb3586cb25c4a
Content-Length: 520
X-Kong-Admin-Latency: 327
Server: kong/3.9.0.0-enterprise-edition