Publish problems
Updated 2026-11-13
Publishing, republishing or saving is refused or fails. This page lists each message the editor shows, why it appears and what to do.
Messages when publishing
| Message | Cause | Fix |
|---|---|---|
| "Please save your changes before publishing" | There are unsaved changes. Publishing takes the saved state. | Click Save (Speichern), then Publish (Veröffentlichen). |
| "Please define at least one input, output, or editable area" | The service has no parameters, so there is nothing a caller could send or receive. | Add at least one input or output, save, then publish. See Add inputs and Add outputs. |
| "Cannot publish: No parameters defined. Please add inputs or outputs first." | The same, noticed before the workbook was loaded. | Open Configuration (Konfiguration), add inputs or outputs, save, then publish. |
| Dialog "Workbook Required for Publishing" | Publishing needs the workbook, and it is not loaded in this browser tab yet. | Click Switch to Configuration (Zur Konfiguration wechseln), wait until the sheet is visible, then click Publish again. |
| "Please wait for the workbook to load, then click Publish again." | You switched to the workbook; it is still loading. | Wait for the sheet, then publish. |
| "Your plan includes one published service" | Your plan's number of published services is reached. | Unpublish the other service, or click Upgrade in the message. See below. |
| "Failed to publish service: …" | Publishing was started and did not finish; the reason follows the colon. | See "Publishing fails with a reason" below. |
German texts: "Bitte speichere zuerst deine Änderungen", "Bitte definiere mindestens eine Eingabe, Ausgabe oder einen editierbaren Bereich", "Dein Plan enthält einen veröffentlichten Service".
A successful publish answers "Service published."
The plan's limit: "Your plan includes one published service"
The full message is: "Unpublish the other service first, or upgrade to Pro to publish any number of services."
- Drafts do not count. You can keep any number of drafts and edit them.
- A service that is already published can always be published again. The limit only refuses a further service.
- To put another service online on the same plan, open the one that is published, click the status button Published (Veröffentlicht) and choose Unpublish (Deaktivieren). Its address then answers 404 until it is published again.
- To have several services online at once, upgrade with the Upgrade button in the message.
Details: The published services limit and Upgrade and billing.
Publishing fails with a reason
"Failed to publish service: …" names the reason after the colon.
- The reason mentions "Workbook only contains Sheet1" and that the template may not have finished loading. The parameters point to sheets that were not loaded yet. Wait until the workbook is fully visible in Configuration, then publish again.
- The reason is "Unknown error", or a network message. Check your connection, reload the page and publish again. Your saved work is not affected.
- It keeps failing. Note the full message and the time and contact support.
While a large workbook is published, a progress window shows the steps ("Publishing Service — Large workbooks may take a moment to upload..."). Keep the tab open until it closes.
Messages when republishing or unpublishing
Republishing has the same checks as publishing:
| Message | Fix |
|---|---|
| "Please save your changes before republishing" | Save first. |
| "Cannot republish: No parameters defined. Please add inputs or outputs first." | Add at least one input or output, save, republish. |
| Dialog "Workbook Required for Republishing" | Click Switch to Configuration, wait for the sheet, republish. |
| "Failed to republish service: …" | As under "Publishing fails with a reason". |
| "Please save your changes before unpublishing" | Save first, then unpublish. |
| "Failed to unpublish: …" | Reload the page and try again. |
A successful republish answers "Service republished. New calls use the new version."; a successful unpublish answers "Service unpublished successfully!".
Messages when saving
You must save before you can publish, so a failed save blocks publishing.
| Message | Cause | Fix |
|---|---|---|
| "No changes to save" | Everything is saved already. | Nothing to do; publish. |
| "Save already in progress" | A save is still running. | Wait until it has finished. |
| "Please wait for the workbook to load before saving" | The workbook was still loading. | Wait for the sheet, then save. |
| "Failed to save: This workbook is … . The … plan allows … per workbook." | The workbook is larger than your plan allows for one workbook. | Make the workbook smaller or upgrade. |
| "Failed to save: With this workbook the account would hold … . The … plan allows … over all workbooks." | All workbooks of the account together would exceed the plan's storage. | Make this or another workbook smaller, or delete a service you no longer need. See Plans overview for larger plans. |
| "Failed to save: …" with another reason | The save did not reach the server or was refused. | Check your connection and save again; do not close the tab before the save has succeeded. |
A workbook that is already over the limit can still be saved as long as it does not grow. Sizes per plan and ways to shrink a workbook: File size limits.
Published, but callers see no change
Publishing worked if the success message appeared. If callers still get old results:
- New calls use the new version. Answers are not stored by browsers or networks.
- Check that you saved and republished the service the callers use, not a copy.
See Wrong or old results.
For developers and agents
- The editor enforces this order: save → publish. Publish, republish and unpublish are refused while there are unsaved changes.
- A service needs at least one input, output or AI area to be published.
- The publish limit carries the code
PUBLISH_LIMIT; the workbook size limits carryWORKBOOK_TOO_LARGE(one workbook) andSTORAGE_LIMIT(all workbooks of the account). - An agent connected to the account gets the code
publish_limitwhen it publishes beyond the plan, with the sentence to pass on to the user; see Agent errors and Rights and limits of an agent. - For an agent: when publishing is refused by the plan, do not unpublish another service on your own. Tell the user the two options — unpublish the other service or upgrade to Pro — and let the user decide.
FAQ
What does "Please save your changes before publishing" mean?
The service has unsaved changes, and publishing takes the saved state. Click Save (Speichern), then Publish (Veröffentlichen).
What does "Your plan includes one published service" mean?
Your plan allows one service online at a time and another one is already published. Unpublish the other service, or upgrade to Pro to publish any number of services.
What does "Please define at least one input, output, or editable area" mean?
A service without parameters cannot be published, because callers would have nothing to send or receive. Add an input or an output in Configuration, save and publish.
What does "Workbook Required for Publishing" mean?
Publishing needs the workbook loaded in the editor. Click Switch to Configuration, wait until the sheet is visible and click Publish again.
What does "Failed to publish service" mean?
Publishing started but did not finish; the text after the colon gives the reason. Wait until the workbook is fully loaded, check your connection and try again; contact support with the full message if it stays.
Why can't I save? It says the workbook is too large.
The workbook is larger than your plan allows, so the save was refused. Make the workbook smaller or upgrade; see File size limits.
Do drafts count toward the published services limit?
No. Only services that are online count; you can keep any number of drafts.
Can I republish my service when I am at the plan's limit?
Yes. A service that is already published can always be published again; the limit only refuses a further service.
What happens to callers while I republish?
They keep getting answers; the service is not taken offline for a republish. Once republishing has succeeded, calls are answered by the new version.
What does "No changes to save" mean?
Everything is already saved. You can publish or republish right away.
I published, but the API still answers "Not found". Why?
Check that the success message appeared and that the id in your address is the id of this service. See 404: not found or not published.
How do I take a service offline?
Open it, click the status button Published (Veröffentlicht) and choose Unpublish (Deaktivieren). Its address answers 404 until you publish it again; the draft and its settings stay.