AI: Unable to configure API Connector action - Missing oauth option error

Hello everyone. Trying to set up an Api Action from the Server Connect with AI, I noticed that AI (all models) has problem to modify the server connect file.
Then I requested a brief report to add here to understand what is the problem.

Any suggestion is appreciated.
Regards

Roberto. **

Description:**

I'm trying to configure an API Connector action in a Server Connect file (swtch_to_embed.json) to make a POST request to a local API endpoint. The action step is already created but empty, and I need to add the configuration details.

Target Configuration:

{
  "target_mode": "embed_exclusive",
  "reason": "Avvio processing documenti",
  "priority": 7,
  "force": false
}

Problem:

When attempting to update the API action step using the replace_action_step function, I receive this error:

Problem:

When attempting to update the API action step using the replace_action_step function, I receive this error:

What I've tried:

  1. Adding "oauth": "" (empty string) to the options object - still getting the error

  2. The API endpoint doesn't require OAuth authentication, just a simple POST request with JSON data

Current file structure:

{
  "settings": {"options": {}},
  "meta": {"options": {}},
  "exec": {
    "steps": {
      "name": "api",
      "module": "api",
      "action": "send",
      "options": {},
      "output": true
    }
  }
}

Question:

What is the correct way to configure the oauth option in the API Connector when no OAuth authentication is required? The validation is blocking the update even when providing an empty string for the oauth field.

Is this a required field that must reference a global OAuth module, or should there be a way to specify "no authentication" for simple API calls?

Hi Roberto,

Could you clarify a few points?

  • Are you asking the AI Assistant to modify the Server Connect file directly (for example, “add a POST API step”), or are you editing it manually and only using AI for guidance?
  • When you mention the replace_action_step function is that something the AI shows or are you calling it yourself somehow?
  • And which AI model are you using when this happens?

Hello Theodor,

as first attempt, I created the file and then I ask Claude Sonnet 4.5:

Create an API Action to make the following call:

curl -X POST http://localhost:9000/switch
-H "Content-Type: application/json"
-d '{
"target_mode": "embed_exclusive",
"reason": "Start document processing",
"priority": 7,
"force": false
}'

I had the problem, so I added the API Action component and gave the following prompt:

I've already added the API Action component in switch_to_embed. Please add the missing information: curl -X POST http://localhost:9000/switch -H "Content-Type: application/json" -d '{ "target_mode": "embed_exclusive", "reason": "Starting document processing", "priority": 7, "force": false }'

He then began trying to edit the file unsuccessfully, always mentioning OAuth authentication.
Finally, I asked him to provide a brief report on the issue to share with the community, which is what you'll find in the first message.

I tried changing the model, but I had the same problem with:

Claude Sonnet 4.5
GPT-4.1
GPT-5

You don't actually need an oauth step for what you're trying to do, so you can remove it from the server action.

I never add an oauth authentication. It is the AI model who mention it.

Maybe just mention in the chat window to simply use an api action step and don't use oauth in this server action.