API-Key erneuern

Ersetzt den Schlüssel dieser App.

Ohne Überlappung: der alte Schlüssel gilt ab dieser Antwort nicht mehr. Trag den neuen ein, bevor du rotierst — oder rechne mit einer Lücke.

POST https://apps.api.usenotification.artim-industries.com/v1/apps/{id}/key/rotate


Methode	`POST`
Basis	`apps.api.usenotification.artim-industries.com/v1`
Scope	`un.apps.key:rotate`
Antwort	`200`
Zugang	Developer Mitgliedschaft
Auth	`Authorization: Bearer unapi_…`

Parameter

Parameter	Ort	Typ	Pflicht	Bedeutung
`id`	Pfad	`string`	ja	Die Kennung der App.

Dieser Endpunkt braucht keinen Körper.

curl -X POST "https://apps.api.usenotification.artim-industries.com/v1/apps/{id}/key/rotate" \
  -H "Authorization: Bearer unapi_…"

{ "appId": "66bcfadc…", "apiKey": "unkey_91ab…", "rotatedAt": "2026-08-21T09:12:00" }

Status	`code`	Wann
`400`	`invalid_request`	Ein Pflichtfeld fehlt, ein Typ passt nicht, oder ein Verweis zeigt auf etwas, das es hier nicht gibt.
`401`	`invalid_token`	Bearer fehlt, ist unbekannt oder abgelaufen.
`403`	`missing_scope`	Das Token trägt den Scope dieses Endpunkts nicht.
`404`	`not_found`	Der Eintrag gehört nicht zum freigegebenen Anbieter — oder die Anfrage kam auf der falschen Subdomain an.
`409`	`conflict`	Der Zustand verbietet die Änderung — der Fehlerkörper nennt den Grund.
`429`	`rate_limited`	Kontingent erschöpft, siehe `Retry-After`.

Jede Fehlerantwort trägt dieselbe Hülle: error.code benennt den Fehler, error.message sagt in einem Satz, was fehlt.

Das Limit gilt pro Team, nicht pro Token.

Zugang	Produktion	Sandbox
Hobby	60 Anfragen/Minute	ohne Limit
Developer Mitgliedschaft	10.000 Anfragen/Minute	ohne Limit

Bei 429 sagt der Retry-After-Header, wie lange du warten sollst.