Relay löschen

2 min Lesezeit · zuletzt aktualisiert 18. August 2026

In API Explorer austestenÖffnet den Explorer mit Methode und Pfad dieses Requests.

Löscht ein Relay, das kein Server benutzt.

Erreichen noch Server ShellBase über dieses Relay, antwortet der Endpunkt mit 409 und nennt ihre Zahl.

DELETE https://relays.api.shellbase.artim-industries.com/v1/relays/{id}


Methode	`DELETE`
Basis	`relays.api.shellbase.artim-industries.com/v1`
Scope	`sb.relays:delete`
Antwort	`204`
Zugang	Developer Mitgliedschaft
Auth	`Authorization: Bearer sbapi_…`

Parameter

Parameter	Ort	Typ	Pflicht	Bedeutung
`id`	Pfad	`string`	ja	Kennung des Relays.

Dieser Endpunkt braucht keinen Körper.

curl -X DELETE "https://relays.api.shellbase.artim-industries.com/v1/relays/{id}" \
  -H "Authorization: Bearer sbapi_…"

204 No Content — die Antwort hat keinen Körper.

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 Team — 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.