Skip to main content
POST
Data App umbenennen
POST https://api-datahub.octoparse.com/v1/data-apps/{app_id}/rename Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>). Nur App-Autor; andere erhalten 404. Rename ist voll offen — nicht auf Zero-Release-Apps beschränkt. App-Name = Routing-Alias: Rename published keine Version, invalidiert keine alten Versionen und betrifft keine laufenden Runs (alle durable Referenzen pinnen app_id). Kaputte Caller-Referenzen sind Sache des Developers: alte owner/old-name-Referenzen (MCP-Pins, SDKs, REST, Detail-URLs) liefern nach Rename sauberes 404 ohne Redirect. Historische Runs und Abrechnung zeigen den neuen Namen. Der alte Name ist in Ihrem Namespace nicht von anderen claimbar, aber Sie können ihn später für eine neue App wiederverwenden — residuale externe Referenzen würden dann auf die neue App zeigen. Consumer sollten über app_id integrieren. Die Validierung entspricht dem Anlegen der Identität: Benennungsregeln → reservierte Wörter → neuer Name ≠ aktueller Name. Ein Konflikt mit der historischen Bindung einer anderen Person ist 409 app-name-reserved; ein Konflikt mit einer anderen Ihrer Apps ist 409 app-name-taken.

Anfrage

Pfadparameter

string
erforderlich
App-Referenz.

Anfrage-Body

string
erforderlich

Beispielanfrage

Antwort

200 Erfolg

Payload ist in data gewrappt. Felder:
string
erforderlich
Stabile App-ID — unverändert.
string
erforderlich
Neuer Name.
string
Publisher-Benutzername.

Fehler

Fehlerantworten nutzen {"error": {code, category, message, retryable}}. Siehe Fehler.

Client-Bibliotheken

Die Python- und JavaScript-SDKs wrappen diesen Endpoint noch nicht. REST direkt aufrufen.