API-fel
Varje fel från fremforges API är RFC 9457 application/problem+json och har en type-URI som namnger det specifika felet:
{
"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."
}Styr din felhantering på type. title och detail är skrivna för människor och kan formuleras om; type tillsammans med status är det stabila kontraktet.
Tabellerna nedan listar 259 feltyper.
400 Bad Request
Begäran var felaktigt utformad, eller så klarade ett fält inte valideringen.
| Feltyp | |
|---|---|
confirm-mismatch | Bekräftelsen stämmer inte |
create-failed | Det gick inte att skapa |
css-too-large | CSS för stor |
digest-mismatch | Digest stämmer inte |
empty-update | Tom uppdatering |
format-mismatch | Formatet stämmer inte |
group-team-map-foreign-org | Gruppmappningen namnger en annan organisation |
group-team-map-unknown-team | Gruppmappningen namnger ett team som inte finns |
ids-required | Id:n krävs |
invalid-access | Ogiltig åtkomst |
invalid-allowed-audiences | Ogiltiga tillåtna audiences |
invalid-allowlist | Ogiltig tillåtlista |
invalid-api-key | Ogiltig API-nyckel |
invalid-artifact-name | Ogiltigt artefaktnamn |
invalid-artifact-version | Ogiltig artefaktversion |
invalid-attestation-format | Ogiltigt attesteringsformat |
invalid-audiences | Ogiltiga audiences |
invalid-azure-deployment | Ogiltig Azure-driftsättning |
invalid-base-url | Ogiltig bas-URL |
invalid-billing-emails | Ogiltiga faktureringsadresser |
invalid-block-action | Ogiltig blockeringsåtgärd |
invalid-block-severity | Ogiltig allvarlighetsgrad för blockering |
invalid-body | Ogiltigt innehåll i begäran |
invalid-ca-keys | Ogiltiga CA-nycklar |
invalid-cidr | Ogiltig CIDR |
invalid-client-id | Ogiltigt klient-id |
invalid-commit-sha | Ogiltig commit-SHA |
invalid-content | Ogiltigt innehåll |
invalid-css | Ogiltig CSS |
invalid-cursor | Ogiltig markör |
invalid-days | Ogiltigt antal dagar |
invalid-digest | Ogiltig digest |
invalid-domain | Ogiltig domän |
invalid-email | Ogiltig e-postadress |
invalid-enabled | Ogiltigt enabled-värde |
invalid-environment | Ogiltig miljö |
invalid-expected-current-seat-cap | Ogiltigt förväntat nuvarande användartak |
invalid-expires-at | Ogiltig utgångstid |
invalid-feature | Ogiltig funktion |
invalid-field | Ogiltigt fält |
invalid-format | Ogiltigt format |
invalid-gates | Ogiltiga gates |
invalid-git-ref | Ogiltig Git-ref |
invalid-group-team-map | Ogiltig mappning från grupp till team |
invalid-input | Ogiltig indata |
invalid-json | Ogiltig JSON |
invalid-label | Ogiltig etikett |
invalid-max-tokens | Ogiltigt maxantal tokens |
invalid-messages | Ogiltiga meddelanden |
invalid-mode | Ogiltigt läge |
invalid-model | Ogiltig modell |
invalid-multipart | Ogiltig multipart |
invalid-name | Ogiltigt namn |
invalid-pattern | Ogiltigt mönster |
invalid-pr-number | Ogiltigt PR-nummer |
invalid-provider | Ogiltig leverantör |
invalid-purpose | Ogiltigt syfte |
invalid-repo | Ogiltigt repo |
invalid-repo-filter | Ogiltigt repofilter |
invalid-repo-full-name | Ogiltigt fullständigt reponamn |
invalid-request | Ogiltig begäran |
invalid-require-cert | Ogiltigt require_cert-värde |
invalid-role | Ogiltig roll |
invalid-rules-url | Ogiltig regel-URL |
invalid-run-id | Ogiltigt körnings-id |
invalid-scope | Ogiltigt scope |
invalid-scopes | Ogiltiga scopes |
invalid-seat-cap | Ogiltigt användartak |
invalid-seats | Ogiltigt antal användare |
invalid-secret | Ogiltig hemlighet |
invalid-since | Ogiltigt since-värde |
invalid-sla | Ogiltigt SLA |
invalid-slug | Ogiltig slug |
invalid-source-repo | Ogiltigt källrepo |
invalid-status | Ogiltig status |
invalid-sub-template | Ogiltig sub-mall |
invalid-target-url | Ogiltig mål-URL |
invalid-team | Ogiltigt team |
invalid-technical-admin-email | Ogiltig e-postadress för teknisk administratör |
invalid-temperature | Ogiltig temperatur |
invalid-tenant-slug | Ogiltig tenant-slug |
invalid-term | Ogiltig term |
invalid-ttl | Ogiltig TTL |
invalid-type | Ogiltig typ |
invalid-url | Ogiltig URL |
invalid-username | Ogiltigt användarnamn |
invalid-value | Ogiltigt värde |
invalid-vendor | Ogiltig leverantör |
missing-assertion | Assertion saknas |
missing-params | Parametrar saknas |
missing-sbom | SBOM saknas |
no-fields | Inga fält |
no-scopes | Inga scopes |
pause-failed | Pausningen misslyckades |
reason-required | Orsak krävs |
reason-too-long | Orsaken är för lång |
removed-setting | Borttagen inställning |
reserved-prefix | Reserverat prefix |
saml-not-offered | SAML erbjuds inte |
seat-change-failed | Användarändringen misslyckades |
too-many-events | För många händelser |
too-many-ids | För många id:n |
too-many-messages | För många meddelanden |
too-many-teams | För många team |
unknown-scope | Okänt scope |
unsupported-grant-type | Grant-typen stöds inte |
unsupported-spec-version | Specifikationsversionen stöds inte |
value-too-large | Värdet är för stort |
401 Unauthorized
Autentisering saknas, eller så avvisades autentiseringsuppgiften.
| Feltyp | |
|---|---|
authentication-required | Autentisering krävs |
invalid-client | Ogiltig klient |
invalid-token | Ogiltig token |
403 Forbidden
Autentiseringsuppgiften är giltig men får inte göra det här.
| Feltyp | |
|---|---|
auditor-read-only | Granskare med enbart läsbehörighet |
console-only | Endast i konsolen |
cross-tenant | Över tenantgränsen |
insufficient-scope | Otillräckligt scope |
not-in-allowlist | Inte i tillåtlistan |
oauth-session-pat-mint-forbidden | Utfärdande av PAT från OAuth-session förbjudet |
protected-account | Skyddat konto |
repo-owner-mismatch | Repots ägare stämmer inte |
scope-escalation | Utökning av scope |
step-up-required | Förhöjd autentisering krävs |
tenant-scope-required | Tenant-scope krävs |
user-identity-required | Användaridentitet krävs |
wildcard-mint-refused | Utfärdande med jokertecken nekat |
404 Not Found
Resursen finns inte, eller så kan din token inte se den.
| Feltyp | |
|---|---|
attempt-not-found | Försöket hittades inte |
no-active-approval | Inget aktivt godkännande |
no-findings | Inga fynd |
not-found | Hittades inte |
rule-fix-not-found | Regelbaserad fix: fyndet finns inte |
tenant-not-found | Tenanten hittades inte |
409 Conflict
Begäran står i konflikt med resursens nuvarande tillstånd.
| Feltyp | |
|---|---|
already-accepted | Redan accepterad |
already-cancelled | Redan avbruten |
already-disabled | Redan avstängt |
already-paused | Redan pausat |
already-resolved | Redan löst |
checkout-in-flight | Utcheckning pågår |
domain-verification-required | Domänverifiering krävs |
dry-run-expired | Torrkörningen har gått ut |
duplicate-grant | Dubblett av behörighet |
duplicate-key | Dubblettnyckel |
duplicate-name | Dubblettnamn |
duplicate-pattern | Dubblettmönster |
duplicate-pending | Dubblett väntar redan |
internal-tenant | Intern tenant |
last-owner | Sista ägaren |
name-conflict | Namnkonflikt |
no-ca-keys | Inga CA-nycklar |
no-rewrites | Inga omskrivningar |
no-seats-available | Inga lediga användare |
not-cancelled | Inte avbruten |
not-cancelling | Avbryts inte |
not-enabled | Inte aktiverat |
not-enrolled | Inte anmäld |
not-pending | Väntar inte på beslut |
not-removed | Inte borttagen |
operator-managed | Hanteras av operatören |
overage-frozen | Överförbrukning fryst |
overage-paid-plan-only | Överförbrukning bara för betalda abonnemang |
refund-unavailable | Återbetalning otillgänglig |
rescan-skipped | Omskanning hoppades över |
rule-fix-already-proposed | Regelbaserad fix: en fix pågår redan eller är öppen |
rule-fix-disabled | Regelbaserad fix: AutoFix är avstängt för organisationen |
rule-fix-not-open | Regelbaserad fix: fyndet är avfärdat |
seat-cap-reached | Användartaket är nått |
self-approve | Eget godkännande |
send-in-progress | Utskick pågår |
stale-seat-cap | Inaktuellt användartak |
tenant-not-accepting | Tenanten tar inte emot |
410 Gone
Resursen har funnits och är borta för gott.
| Feltyp | |
|---|---|
challenge-expired | Utmaningen har gått ut |
logs-purged | Loggarna är rensade |
413 Payload Too Large
Innehållet är större än vad den här endpointen tar emot.
| Feltyp | |
|---|---|
payload-too-large | Innehållet är för stort |
too-many-rows | För många rader |
415 Unsupported Media Type
Begärans Content-Type stöds inte.
| Feltyp | |
|---|---|
unsupported-media-type | Medietypen stöds inte |
422 Unprocessable Content
Begäran var korrekt utformad, men resursen kan inte hanteras på det här sättet.
| Feltyp | |
|---|---|
rule-fix-check-not-supported | Regelbaserad fix: IaC-kontrollen har ingen regelbaserad fix |
rule-fix-language-not-supported | Regelbaserad fix: filens språk stöds inte |
rule-fix-path-refused | Regelbaserad fix: filen är en som AutoFix aldrig ändrar |
rule-fix-pr-finding | Regelbaserad fix: fyndet togs upp i en pull request |
429 Too Many Requests
Du har överskridit en hastighetsgräns.
| Feltyp | |
|---|---|
rate-limited | Hastighetsbegränsad |
rate-limited-global | Global hastighetsgräns |
rule-fix-org-daily-limit | Regelbaserad fix: organisationen har nått sin dagliga AutoFix-gräns |
rule-fix-rate-limited | Regelbaserad fix: en fix provades nyligen |
rule-fix-repo-limit | Regelbaserad fix: repot har för många öppna AutoFix-pull requests |
500 Internal Server Error
Något gick fel hos oss.
| Feltyp | |
|---|---|
db-error | Databasfel |
insert-failed | Infogning misslyckades |
internal | Internt |
internal-error | Internt fel |
rate-limit-misconfigured | Hastighetsgränsen är felkonfigurerad |
sign-failed | Signeringen misslyckades |
501 Not Implemented
Inte implementerat än.
| Feltyp | |
|---|---|
not-implemented-yet | Inte implementerat än |
502 Bad Gateway
Ett beroende i upstream returnerade ett fel.
| Feltyp | |
|---|---|
approve-failed | Godkännandet misslyckades |
ci-bot-mint-failed | Utfärdande för CI-bot misslyckades |
ci-bot-revoke-failed | Återkallning av CI-bot misslyckades |
forgejo-error | Fel i Forgejo |
forgejo-failed | Forgejo misslyckades |
forgejo-upstream-error | Fel från Forgejo i upstream |
install-failed | Installationen misslyckades |
mollie-error | Fel i Mollie |
mollie-unavailable | Mollie otillgängligt |
obs-put-failed | Uppladdning till OBS misslyckades |
pr-open-failed | Det gick inte att öppna PR |
provisioning-failed | Provisioneringen misslyckades |
remove-failed | Borttagningen misslyckades |
revoke-failed | Återkallningen misslyckades |
test-failed | Testet misslyckades |
upstream-auth-failed | Autentisering mot upstream misslyckades |
upstream-error | Fel från upstream |
upstream-unreachable | Upstream går inte att nå |
503 Service Unavailable
Ett beroende är tillfälligt otillgängligt.
| Feltyp | |
|---|---|
ai-disabled | AI avstängt |
attestations-disabled | Attesteringar avstängda |
billing-unavailable | Fakturering otillgänglig |
ci-bots-unavailable | CI-bottar otillgängliga |
forgejo-not-configured | Forgejo är inte konfigurerat |
forgejo-proxy-disabled | Forgejo-proxy avstängd |
forgejo-unavailable | Forgejo otillgängligt |
forgejo-unreachable | Forgejo går inte att nå |
invitations-unavailable | Inbjudningar otillgängliga |
not-configured | Inte konfigurerat |
ownership-unverifiable | Ägarskapet kan inte verifieras |
renovate-disabled | Renovate avstängt |
rule-fix-unavailable | Regelbaserad fix: regelbaserade fixar är inte konfigurerade |
sbom-ingest-unavailable | SBOM-inläsning otillgänglig |
seat-change-unavailable | Användarändring otillgänglig |
seat-holds-unavailable | Reservationer av användare otillgängliga |
secrets-unavailable | Secrets otillgängliga |
siem-unavailable | SIEM otillgängligt |
token-exchange-disabled | Tokenutbyte avstängt |
Avslag för säkerhetsfixar och AI-fixar
Sedan 2026-10-14 svarar POST /orgs/{org}/dependency-updates/security-fixes/requests med dessa som security-fix-<reason> och POST /orgs/{org}/code-security/sast/findings/{id}/ai-fix som ai-fix-<reason>; varje sida nedan täcker båda stavningarna. De utfasade sökvägarna fortsätter att svara autofix-<reason> fram till 2027-10-15. Returneras av 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 och POST /orgs/{org}/code-security/sast/findings/{id}/autofix när ingen pull request begärs. Se Säkerhetsfixar.
Avslag vid byte av säkerhetsspår
Returneras av PUT /orgs/{org}/dependency-updates/security-fixes/lane när spåret Säkerhetsfixar inte kan ta över från hostad Renovate. Se Ta över från Renovate.
| Feltyp | Status |
|---|---|
security-lane-lane-off | 409 |
security-lane-unsupported-ecosystems | 409 |