Rename, reorder and remove parameters

How to change the name, the cell and the order of inputs and outputs, how to remove one, which changes affect the callers of a published service, and how to make such changes safely.

Edit a parameter

1. Open the service on the Configuration (Konfiguration) tab. The panel on the right lists the inputs and outputs.
2. Hover over the parameter and click the pencil (Edit, Bearbeiten). The dialog Edit Input Parameter or Edit Output Parameter opens.
3. Change what you need: - Parameter Name (Parametername): the name callers use. - Original Title (Originaltitel): the readable title. - Cell Address (Zelladresse): the cell or range, for example Sheet1!B2. - the data type, rules and format, and the texts under AI Info (KI Info).
4. Click Update Parameter (Parameter aktualisieren).
5. Click Save (Speichern).

Clicking a parameter, without the pencil, jumps to its cell in the workbook and selects it. That is the quickest way to see what a parameter points at.

Reorder

Each parameter has a handle with six dots on its left. Drag it up or down to move the parameter within its list. Inputs and outputs are ordered separately.

The order is more than cosmetic:

• Outputs are returned in this order in outputs. With _format=csv the columns follow it too.
• Inputs are listed in this order when the service describes itself, for example to AI assistants and in the documentation.

Remove

1. Hover over the parameter and click the bin (Delete, Löschen).
2. Confirm Delete this parameter? (Parameter löschen?) with Yes (Ja). The dialog notes that this cannot be undone.
3. Click Save.

Removing a parameter does not change the workbook. The cell keeps its value or formula; it is just no longer an input or output. To get the parameter back, add the cell again.

When changes reach callers

Everything on this page changes the draft. A published service keeps its published inputs and outputs until you click Save and then Republish (Neu veröffentlichen). You can therefore prepare several changes and make them live together. See Publish and republish.

What breaks for callers

Callers address inputs and read outputs by name. After you republish:

Connected tools keep a copy of the parameter list in some cases: an automation flow or a generated client may need to refresh the service's definition after you change parameters. AI assistants read the current definition when they connect.

Change safely

Before the first publish nothing can break. Settle the names then.

For a published service:

• Rename an output: add a second output on a formula cell that references the first, for example =B5, under the new name. Republish, move your callers to the new name, then remove the old output and republish again.
• Rename an input: tell callers first. A renamed input cannot be accepted under both names, so plan one moment for the switch, or leave the name as it is and change only the title.
• Add an input: add it as optional with a default that reproduces the old behaviour. Existing calls keep working.
• Remove an input: remove it; existing calls keep working. Check first that the cell holds the value your formulas should use from now on.
• Change only what people see: the title is free to change at any time.

Test the draft before you republish; see Test before publishing. After republishing, the Usage (Nutzung) tab shows whether calls start to fail; see Usage overview.

Names

The dialog stores a name in lower case. Use lower-case letters, digits and _, start with a letter or _, and give each input and each output its own name. Callers may write a name in any case.

For developers and agents

• The key of an input in a request, and of an output in outputs[].name and result, is the parameter's name.
• A key that matches no input is ignored and does not cause an error. After a rename, a stale key therefore fails only if the input is required.
• outputs is a list in panel order; result (with flatten=true) is an object keyed by name.
• To detect changes, read the service's definition before calling; see The discovery address and OpenAPI and interactive docs.
• An AI agent connected to the account sets all inputs and outputs of a service in one step and must publish again afterwards; see What an agent can do.

FAQ

How do I rename an input or output?

Hover over it in the panel, click the pencil, change Parameter Name and click Update Parameter. Then save and republish.

Will renaming a parameter break my API calls?

Yes, for calls that use the old name, once you republish. A renamed required input makes old calls fail with "Missing required parameters"; a renamed output is no longer found under its old name.

How do I change the order of my parameters?

Drag a parameter by the six-dot handle on its left. Inputs and outputs are ordered separately.

How do I delete a parameter?

Hover over it, click the bin and confirm with Yes. Then save and republish; the workbook itself is not changed.

Can I undo deleting a parameter?

Not with an undo button. Before saving you can reload the page to get the saved state back; otherwise add the cell again and re-enter its settings.

I changed a parameter but the API still behaves as before. Why?

Changes apply to the draft until you publish. Click Save, then Republish.

Can I change only the title without affecting callers?

Yes. Callers use the name; the title is the readable label. Changing the title changes what people and AI assistants see, not how the service is called.

How do I point a parameter at another cell?

Open it with the pencil and change Cell Address, including the sheet name, for example Sheet1!B7. Then save and republish.

Does removing an input break existing calls?

No. A value sent for an input that no longer exists is ignored. Make sure the cell holds the value the calculation should use from now on.

As an agent, how do I notice that a service's parameters changed?

Read the service's definition before you call and use the names it lists. If a call answers "Missing required parameters", read the definition again and send the names from details.required.