Zum Hauptinhalt springen

API-Fehler

Jeder Fehler der fremforge-API ist RFC 9457 application/problem+json und trägt eine type-URI, die den konkreten Fehler benennt:

{
  "type": "https://docs.frem.sh/reference/api/errors/seat-cap-reached",
  "title": "Seat cap reached",
  "status": 409,
  "detail": "Your org has 10 of 10 contracted seats in use. Buy more seats from the billing page before provisioning new users."
}

Werte type aus. title und detail sind für Menschen gedacht und können umformuliert werden; type zusammen mit status ist der stabile Vertrag.

Die Tabellen unten führen 259 Fehlertypen auf.

400 Bad Request

Die Anfrage war fehlerhaft, oder ein Feld hat die Validierung nicht bestanden.

Fehlertyp
confirm-mismatchBestätigung stimmt nicht überein
create-failedAnlegen fehlgeschlagen
css-too-largeCSS zu groß
digest-mismatchDigest stimmt nicht überein
empty-updateLeere Aktualisierung
format-mismatchFormat stimmt nicht überein
group-team-map-foreign-orgGruppen-Team-Zuordnung nennt eine andere Organisation
group-team-map-unknown-teamGruppen-Team-Zuordnung nennt ein Team, das es nicht gibt
ids-requiredIDs erforderlich
invalid-accessUngültiger Zugriffswert
invalid-allowed-audiencesUngültige erlaubte Audiences
invalid-allowlistUngültige Allowlist
invalid-api-keyUngültiger API-Schlüssel
invalid-artifact-nameUngültiger Artefaktname
invalid-artifact-versionUngültige Artefaktversion
invalid-attestation-formatUngültiges Attestierungsformat
invalid-audiencesUngültige Audiences
invalid-azure-deploymentUngültiges Azure-Deployment
invalid-base-urlUngültige Basis-URL
invalid-billing-emailsUngültige Rechnungs-E-Mail-Adressen
invalid-block-actionUngültige Blockieraktion
invalid-block-severityUngültiger Schweregrad für das Blockieren
invalid-bodyUngültiger Body
invalid-ca-keysUngültige CA-Schlüssel
invalid-cidrUngültiger CIDR-Bereich
invalid-client-idUngültige Client-ID
invalid-commit-shaUngültiger Commit-SHA
invalid-contentUngültiger Inhalt
invalid-cssUngültiges CSS
invalid-cursorUngültiger Cursor
invalid-daysUngültige Anzahl Tage
invalid-digestUngültiger Digest
invalid-domainUngültige Domain
invalid-emailUngültige E-Mail-Adresse
invalid-enabledUngültiger Wert für enabled
invalid-environmentUngültige Umgebung
invalid-expected-current-seat-capUngültiges erwartetes aktuelles Nutzerlimit
invalid-expires-atUngültiger Ablaufzeitpunkt
invalid-featureUngültige Funktion
invalid-fieldUngültiges Feld
invalid-formatUngültiges Format
invalid-gatesUngültige Gates
invalid-git-refUngültige Git-Referenz
invalid-group-team-mapUngültige Gruppen-Team-Zuordnung
invalid-inputUngültige Eingabe
invalid-jsonUngültiges JSON
invalid-labelUngültiges Label
invalid-max-tokensUngültige Höchstzahl an Tokens
invalid-messagesUngültige Nachrichten
invalid-modeUngültiger Modus
invalid-modelUngültiges Modell
invalid-multipartUngültiger Multipart-Body
invalid-nameUngültiger Name
invalid-patternUngültiges Muster
invalid-pr-numberUngültige Pull-Request-Nummer
invalid-providerUngültiger Anbieter
invalid-purposeUngültiger Zweck
invalid-repoUngültiges Repository
invalid-repo-filterUngültiger Repository-Filter
invalid-repo-full-nameUngültiger vollständiger Repository-Name
invalid-requestUngültige Anfrage
invalid-require-certUngültiger Wert für require_cert
invalid-roleUngültige Rolle
invalid-rules-urlUngültige Regel-URL
invalid-run-idUngültige Run-ID
invalid-scopeUngültiger Scope
invalid-scopesUngültige Scopes
invalid-seat-capUngültiges Nutzerlimit
invalid-seatsUngültige Nutzerzahl
invalid-secretUngültiges Secret
invalid-sinceUngültiger since-Wert
invalid-slaUngültiges SLA
invalid-slugUngültiger Slug
invalid-source-repoUngültiges Quell-Repository
invalid-statusUngültiger Status
invalid-sub-templateUngültige sub-Vorlage
invalid-target-urlUngültige Ziel-URL
invalid-teamUngültiges Team
invalid-technical-admin-emailUngültige E-Mail-Adresse des technischen Admins
invalid-temperatureUngültige Temperatur
invalid-tenant-slugUngültiger Mandanten-Slug
invalid-termUngültige Laufzeit
invalid-ttlUngültige TTL
invalid-typeUngültiger Typ
invalid-urlUngültige URL
invalid-usernameUngültiger Benutzername
invalid-valueUngültiger Wert
invalid-vendorUngültiger Hersteller
missing-assertionAssertion fehlt
missing-paramsParameter fehlen
missing-sbomSBOM fehlt
no-fieldsKeine Felder
no-scopesKeine Scopes
pause-failedPausieren fehlgeschlagen
reason-requiredBegründung erforderlich
reason-too-longBegründung zu lang
removed-settingEntfernte Einstellung
reserved-prefixReserviertes Präfix
saml-not-offeredSAML wird nicht angeboten
seat-change-failedÄnderung der Nutzerzahl fehlgeschlagen
too-many-eventsZu viele Ereignisse
too-many-idsZu viele IDs
too-many-messagesZu viele Nachrichten
too-many-teamsZu viele Teams
unknown-scopeUnbekannter Scope
unsupported-grant-typeNicht unterstützter Grant-Typ
unsupported-spec-versionNicht unterstützte Spezifikationsversion
value-too-largeWert zu groß

401 Unauthorized

Die Authentifizierung fehlt, oder die Zugangsdaten wurden abgelehnt.

Fehlertyp
authentication-requiredAuthentifizierung erforderlich
invalid-clientUngültiger Client
invalid-tokenUngültiges Token

403 Forbidden

Die Zugangsdaten sind gültig, dürfen das aber nicht.

Fehlertyp
auditor-read-onlyAuditor mit Lesezugriff
console-onlyNur in der Konsole
cross-tenantMandantenübergreifend
insufficient-scopeUnzureichender Scope
not-in-allowlistNicht in der Allowlist
oauth-session-pat-mint-forbiddenPAT-Erzeugung aus einer OAuth-Sitzung verboten
protected-accountGeschütztes Konto
repo-owner-mismatchRepository-Inhaber stimmt nicht überein
scope-escalationScope-Eskalation
step-up-requiredStep-up erforderlich
tenant-scope-requiredMandanten-Scope erforderlich
user-identity-requiredBenutzeridentität erforderlich
wildcard-mint-refusedWildcard-Token-Erzeugung abgelehnt

404 Not Found

Die Ressource existiert nicht – oder dein Token kann sie nicht sehen.

Fehlertyp
attempt-not-foundVersuch nicht gefunden
no-active-approvalKeine aktive Genehmigung
no-findingsKeine Befunde
not-foundNicht gefunden
rule-fix-not-foundRegelbasierte Korrektur: Den Befund gibt es nicht
tenant-not-foundMandant nicht gefunden

409 Conflict

Die Anfrage steht im Konflikt mit dem aktuellen Zustand der Ressource.

Fehlertyp
already-acceptedBereits angenommen
already-cancelledBereits abgebrochen
already-disabledBereits deaktiviert
already-pausedBereits pausiert
already-resolvedBereits gelöst
checkout-in-flightCheckout läuft bereits
domain-verification-requiredDomainverifizierung erforderlich
dry-run-expiredTestlauf abgelaufen
duplicate-grantDoppelte Berechtigung
duplicate-keyDoppelter Schlüssel
duplicate-nameDoppelter Name
duplicate-patternDoppeltes Muster
duplicate-pendingBereits eine ausstehende Anfrage
internal-tenantInterner Mandant
last-ownerLetzter Owner
name-conflictNamenskonflikt
no-ca-keysKeine CA-Schlüssel
no-rewritesKeine Umschreibungen
no-seats-availableKeine Nutzer mehr verfügbar
not-cancelledNicht abgebrochen
not-cancellingWird nicht abgebrochen
not-enabledNicht aktiviert
not-enrolledNicht angemeldet
not-pendingNicht ausstehend
not-removedNicht entfernt
operator-managedVom Operator verwaltet
overage-frozenÜberschreitung eingefroren
overage-paid-plan-onlyÜberschreitung nur in bezahlten Tarifen
refund-unavailableErstattung nicht verfügbar
rescan-skippedErneuter Scan übersprungen
rule-fix-already-proposedRegelbasierte Korrektur: Eine Korrektur läuft bereits oder ist offen
rule-fix-disabledRegelbasierte Korrektur: AutoFix ist für die Organisation ausgeschaltet
rule-fix-not-openRegelbasierte Korrektur: Der Befund wurde verworfen
seat-cap-reachedNutzerlimit erreicht
self-approveEigene Genehmigung
send-in-progressVersand läuft bereits
stale-seat-capVeraltetes Nutzerlimit
tenant-not-acceptingMandant nimmt nichts an

410 Gone

Die Ressource hat existiert und ist endgültig weg.

Fehlertyp
challenge-expiredChallenge abgelaufen
logs-purgedLogs gelöscht

413 Payload Too Large

Der Body ist größer, als dieser Endpunkt annimmt.

Fehlertyp
payload-too-largePayload zu groß
too-many-rowsZu viele Zeilen

415 Unsupported Media Type

Der Content-Type der Anfrage wird nicht unterstützt.

Fehlertyp
unsupported-media-typeNicht unterstützter Medientyp

422 Unprocessable Content

Die Anfrage war korrekt aufgebaut, aber die Ressource lässt sich so nicht verarbeiten.

Fehlertyp
rule-fix-check-not-supportedRegelbasierte Korrektur: Für die IaC-Prüfung gibt es keine regelbasierte Korrektur
rule-fix-language-not-supportedRegelbasierte Korrektur: Die Sprache der Datei wird nicht unterstützt
rule-fix-path-refusedRegelbasierte Korrektur: AutoFix ändert diese Datei nie
rule-fix-pr-findingRegelbasierte Korrektur: Der Befund stammt aus einem Pull Request

429 Too Many Requests

Du hast ein Rate-Limit überschritten.

Fehlertyp
rate-limitedRate-Limit erreicht
rate-limited-globalGlobales Rate-Limit erreicht
rule-fix-org-daily-limitRegelbasierte Korrektur: Die Organisation hat ihr tägliches AutoFix-Limit erreicht
rule-fix-rate-limitedRegelbasierte Korrektur: Eine Korrektur wurde kürzlich versucht
rule-fix-repo-limitRegelbasierte Korrektur: Das Repository hat zu viele offene AutoFix-Pull-Requests

500 Internal Server Error

Auf unserer Seite ist etwas fehlgeschlagen.

Fehlertyp
db-errorDatenbankfehler
insert-failedEinfügen fehlgeschlagen
internalIntern
internal-errorInterner Fehler
rate-limit-misconfiguredRate-Limit falsch konfiguriert
sign-failedSignieren fehlgeschlagen

501 Not Implemented

Noch nicht implementiert.

Fehlertyp
not-implemented-yetNoch nicht implementiert

502 Bad Gateway

Eine Upstream-Abhängigkeit hat einen Fehler zurückgegeben.

Fehlertyp
approve-failedGenehmigung fehlgeschlagen
ci-bot-mint-failedToken für CI-Bot konnte nicht erzeugt werden
ci-bot-revoke-failedWiderruf des CI-Bots fehlgeschlagen
forgejo-errorForgejo-Fehler
forgejo-failedForgejo-Aufruf fehlgeschlagen
forgejo-upstream-errorUpstream-Fehler bei Forgejo
install-failedInstallation fehlgeschlagen
mollie-errorMollie-Fehler
mollie-unavailableMollie nicht verfügbar
obs-put-failedUpload nach OBS fehlgeschlagen
pr-open-failedÖffnen des Pull Requests fehlgeschlagen
provisioning-failedBereitstellung fehlgeschlagen
remove-failedEntfernen fehlgeschlagen
revoke-failedWiderruf fehlgeschlagen
test-failedTest fehlgeschlagen
upstream-auth-failedUpstream-Authentifizierung fehlgeschlagen
upstream-errorUpstream-Fehler
upstream-unreachableUpstream nicht erreichbar

503 Service Unavailable

Eine Abhängigkeit ist vorübergehend nicht verfügbar.

Fehlertyp
ai-disabledKI deaktiviert
attestations-disabledAttestierungen deaktiviert
billing-unavailableAbrechnung nicht verfügbar
ci-bots-unavailableCI-Bots nicht verfügbar
forgejo-not-configuredForgejo nicht konfiguriert
forgejo-proxy-disabledForgejo-Proxy deaktiviert
forgejo-unavailableForgejo nicht verfügbar
forgejo-unreachableForgejo nicht erreichbar
invitations-unavailableEinladungen nicht verfügbar
not-configuredNicht konfiguriert
ownership-unverifiableEigentum nicht überprüfbar
renovate-disabledRenovate deaktiviert
rule-fix-unavailableRegelbasierte Korrektur: Regelbasierte Korrekturen sind nicht konfiguriert
sbom-ingest-unavailableSBOM-Import nicht verfügbar
seat-change-unavailableÄnderung der Nutzerzahl nicht verfügbar
seat-holds-unavailableNutzerreservierungen nicht verfügbar
secrets-unavailableSecrets nicht verfügbar
siem-unavailableSIEM nicht verfügbar
token-exchange-disabledToken-Austausch deaktiviert

Ablehnungen von Sicherheits- und KI-Korrekturen

Seit dem 14.10.2026 beantwortet POST /orgs/{org}/dependency-updates/security-fixes/requests diese Fälle als security-fix-<reason> und POST /orgs/{org}/code-security/sast/findings/{id}/ai-fix als ai-fix-<reason>; jede der folgenden Seiten deckt beide Schreibweisen ab. Die veralteten Pfade antworten bis zum 15.10.2027 weiterhin mit autofix-<reason>. Zurückgegeben von POST /orgs/{org}/code-security/deps/findings/{id}/autofix, POST /orgs/{org}/code-security/deps/repos/{repo}/autofix, POST /orgs/{org}/code-security/images/findings/{id}/autofix und POST /orgs/{org}/code-security/sast/findings/{id}/autofix, wenn kein Pull Request angefordert wird. Siehe Sicherheitskorrekturen.

FehlertypStatus
autofix-ai-disabled409
autofix-already-proposed409
autofix-binary-lockfile422
autofix-disabled409
autofix-ecosystem-not-supported422
autofix-feature-off409
autofix-image-no-base-fix422
autofix-image-not-attributed422
autofix-image-not-from-base422
autofix-image-source-unknown422
autofix-language-mismatch422
autofix-manifest-not-supported422
autofix-never-autofixed422
autofix-no-fixed-version422
autofix-no-provider409
autofix-not-curated422
autofix-not-enrolled409
autofix-not-found404
autofix-not-open409
autofix-nothing-fixable422
autofix-org-daily-limit429
autofix-package-not-supported422
autofix-path-refused422
autofix-pr-finding422
autofix-rate-limited429
autofix-repo-ai-disabled409
autofix-repo-limit429
autofix-repo-opted-out409
autofix-sbom-finding422
autofix-unavailable503
security-fix-repo-archived (autofix-repo-archived auf den veralteten Pfaden)409

Ablehnungen beim Wechsel der Sicherheitsspur

Zurückgegeben von PUT /orgs/{org}/dependency-updates/security-fixes/lane, wenn die Spur für Sicherheitskorrekturen die Aufgabe nicht vom gehosteten Renovate übernehmen kann. Siehe Übernahme von Renovate.

FehlertypStatus
security-lane-lane-off409
security-lane-unsupported-ecosystems409