API-fouten
Elke API-fout van fremforge is RFC 9457 application/problem+json en heeft een type-URI die de specifieke fout noemt:
{
"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."
}Baseer je logica op type. title en detail zijn bedoeld voor mensen en kunnen anders worden geformuleerd; type plus status is het stabiele contract.
De tabellen hieronder noemen 259 fouttypes.
400 Bad Request
Het verzoek was onjuist opgebouwd, of een veld kwam niet door de validatie.
| Fouttype | |
|---|---|
confirm-mismatch | Bevestiging komt niet overeen |
create-failed | Aanmaken mislukt |
css-too-large | CSS te groot |
digest-mismatch | Digest komt niet overeen |
empty-update | Lege update |
format-mismatch | Formaat komt niet overeen |
group-team-map-foreign-org | Groep-teamkoppeling noemt een andere organisatie |
group-team-map-unknown-team | Groep-teamkoppeling noemt een team dat niet bestaat |
ids-required | Id’s vereist |
invalid-access | Ongeldige toegang |
invalid-allowed-audiences | Ongeldige toegestane audiences |
invalid-allowlist | Ongeldige allowlist |
invalid-api-key | Ongeldige API-sleutel |
invalid-artifact-name | Ongeldige artefactnaam |
invalid-artifact-version | Ongeldige artefactversie |
invalid-attestation-format | Ongeldig attestatieformaat |
invalid-audiences | Ongeldige audiences |
invalid-azure-deployment | Ongeldige Azure-deployment |
invalid-base-url | Ongeldige basis-URL |
invalid-billing-emails | Ongeldige factuur-e-mailadressen |
invalid-block-action | Ongeldige blokkeeractie |
invalid-block-severity | Ongeldige ernst voor blokkeren |
invalid-body | Ongeldige body |
invalid-ca-keys | Ongeldige CA-sleutels |
invalid-cidr | Ongeldige CIDR |
invalid-client-id | Ongeldige client-id |
invalid-commit-sha | Ongeldige commit-SHA |
invalid-content | Ongeldige inhoud |
invalid-css | Ongeldige CSS |
invalid-cursor | Ongeldige cursor |
invalid-days | Ongeldig aantal dagen |
invalid-digest | Ongeldige digest |
invalid-domain | Ongeldig domein |
invalid-email | Ongeldig e-mailadres |
invalid-enabled | Ongeldige waarde voor enabled |
invalid-environment | Ongeldige omgeving |
invalid-expected-current-seat-cap | Ongeldige verwachte huidige gebruikerslimiet |
invalid-expires-at | Ongeldige vervaldatum |
invalid-feature | Ongeldige functie |
invalid-field | Ongeldig veld |
invalid-format | Ongeldig formaat |
invalid-gates | Ongeldige gates |
invalid-git-ref | Ongeldige Git-ref |
invalid-group-team-map | Ongeldige groep-teamkoppeling |
invalid-input | Ongeldige invoer |
invalid-json | Ongeldige JSON |
invalid-label | Ongeldig label |
invalid-max-tokens | Ongeldig maximum aantal tokens |
invalid-messages | Ongeldige berichten |
invalid-mode | Ongeldige modus |
invalid-model | Ongeldig model |
invalid-multipart | Ongeldige multipart |
invalid-name | Ongeldige naam |
invalid-pattern | Ongeldig patroon |
invalid-pr-number | Ongeldig PR-nummer |
invalid-provider | Ongeldige provider |
invalid-purpose | Ongeldig doel |
invalid-repo | Ongeldige repo |
invalid-repo-filter | Ongeldig repofilter |
invalid-repo-full-name | Ongeldige volledige reponaam |
invalid-request | Ongeldig verzoek |
invalid-require-cert | Ongeldige waarde voor require_cert |
invalid-role | Ongeldige rol |
invalid-rules-url | Ongeldige regels-URL |
invalid-run-id | Ongeldige run-id |
invalid-scope | Ongeldige scope |
invalid-scopes | Ongeldige scopes |
invalid-seat-cap | Ongeldige gebruikerslimiet |
invalid-seats | Ongeldig aantal gebruikers |
invalid-secret | Ongeldig secret |
invalid-since | Ongeldige since-waarde |
invalid-sla | Ongeldige SLA |
invalid-slug | Ongeldige slug |
invalid-source-repo | Ongeldige bronrepo |
invalid-status | Ongeldige status |
invalid-sub-template | Ongeldige subtemplate |
invalid-target-url | Ongeldige doel-URL |
invalid-team | Ongeldig team |
invalid-technical-admin-email | Ongeldig e-mailadres van de technisch beheerder |
invalid-temperature | Ongeldige temperature |
invalid-tenant-slug | Ongeldige tenant-slug |
invalid-term | Ongeldige termijn |
invalid-ttl | Ongeldige TTL |
invalid-type | Ongeldig type |
invalid-url | Ongeldige URL |
invalid-username | Ongeldige gebruikersnaam |
invalid-value | Ongeldige waarde |
invalid-vendor | Ongeldige leverancier |
missing-assertion | Assertion ontbreekt |
missing-params | Parameters ontbreken |
missing-sbom | SBOM ontbreekt |
no-fields | Geen velden |
no-scopes | Geen scopes |
pause-failed | Pauzeren mislukt |
reason-required | Reden vereist |
reason-too-long | Reden te lang |
removed-setting | Verwijderde instelling |
reserved-prefix | Gereserveerd voorvoegsel |
saml-not-offered | SAML wordt niet aangeboden |
seat-change-failed | Wijzigen van gebruikers mislukt |
too-many-events | Te veel gebeurtenissen |
too-many-ids | Te veel id’s |
too-many-messages | Te veel berichten |
too-many-teams | Te veel teams |
unknown-scope | Onbekende scope |
unsupported-grant-type | Niet-ondersteund granttype |
unsupported-spec-version | Niet-ondersteunde specversie |
value-too-large | Waarde te groot |
401 Unauthorized
Authenticatie ontbreekt, of het inloggegeven is geweigerd.
| Fouttype | |
|---|---|
authentication-required | Authenticatie vereist |
invalid-client | Ongeldige client |
invalid-token | Ongeldig token |
403 Forbidden
Het inloggegeven is geldig, maar mag dit niet doen.
| Fouttype | |
|---|---|
auditor-read-only | Auditor met alleen leesrechten |
console-only | Alleen via de console |
cross-tenant | Over tenants heen |
insufficient-scope | Onvoldoende scope |
not-in-allowlist | Niet in de allowlist |
oauth-session-pat-mint-forbidden | PAT aanmaken vanuit OAuth-sessie niet toegestaan |
protected-account | Beschermd account |
repo-owner-mismatch | Repo-eigenaar komt niet overeen |
scope-escalation | Scope-escalatie |
step-up-required | Step-up vereist |
tenant-scope-required | Tenant-scope vereist |
user-identity-required | Gebruikersidentiteit vereist |
wildcard-mint-refused | Aanmaken met wildcard geweigerd |
404 Not Found
De resource bestaat niet, of je token kan hem niet zien.
| Fouttype | |
|---|---|
attempt-not-found | Poging niet gevonden |
no-active-approval | Geen actieve goedkeuring |
no-findings | Geen bevindingen |
not-found | Niet gevonden |
rule-fix-not-found | Fix op basis van regels: de bevinding bestaat niet |
tenant-not-found | Tenant niet gevonden |
409 Conflict
Het verzoek botst met de huidige toestand van de resource.
| Fouttype | |
|---|---|
already-accepted | Al geaccepteerd |
already-cancelled | Al geannuleerd |
already-disabled | Al uitgeschakeld |
already-paused | Al gepauzeerd |
already-resolved | Al opgelost |
checkout-in-flight | Checkout loopt al |
domain-verification-required | Domeinverificatie vereist |
dry-run-expired | Proefrun verlopen |
duplicate-grant | Dubbele toekenning |
duplicate-key | Dubbele sleutel |
duplicate-name | Dubbele naam |
duplicate-pattern | Dubbel patroon |
duplicate-pending | Al een openstaand verzoek |
internal-tenant | Interne tenant |
last-owner | Laatste eigenaar |
name-conflict | Naamconflict |
no-ca-keys | Geen CA-sleutels |
no-rewrites | Geen herschrijvingen |
no-seats-available | Geen gebruikers meer beschikbaar |
not-cancelled | Niet geannuleerd |
not-cancelling | Wordt niet geannuleerd |
not-enabled | Niet ingeschakeld |
not-enrolled | Niet aangemeld |
not-pending | Niet in behandeling |
not-removed | Niet verwijderd |
operator-managed | Beheerd door de operator |
overage-frozen | Overschrijding bevroren |
overage-paid-plan-only | Overschrijding alleen bij een betaald abonnement |
refund-unavailable | Terugbetaling niet beschikbaar |
rescan-skipped | Herscan overgeslagen |
rule-fix-already-proposed | Fix op basis van regels: er loopt al een fix of er staat er al een open |
rule-fix-disabled | Fix op basis van regels: AutoFix staat uit voor de organisatie |
rule-fix-not-open | Fix op basis van regels: de bevinding is afgewezen |
seat-cap-reached | Gebruikerslimiet bereikt |
self-approve | Eigen goedkeuring |
send-in-progress | Verzending loopt al |
stale-seat-cap | Verouderde gebruikerslimiet |
tenant-not-accepting | Tenant accepteert dit niet |
410 Gone
De resource bestond, maar is definitief weg.
| Fouttype | |
|---|---|
challenge-expired | Challenge verlopen |
logs-purged | Logs gewist |
413 Payload Too Large
De body is groter dan dit endpoint accepteert.
| Fouttype | |
|---|---|
payload-too-large | Payload te groot |
too-many-rows | Te veel rijen |
415 Unsupported Media Type
Het Content-Type van het verzoek wordt niet ondersteund.
| Fouttype | |
|---|---|
unsupported-media-type | Niet-ondersteund mediatype |
422 Unprocessable Content
Het verzoek was correct opgebouwd, maar de resource kan niet op deze manier worden verwerkt.
| Fouttype | |
|---|---|
rule-fix-check-not-supported | Fix op basis van regels: de IaC-controle heeft geen fix op basis van regels |
rule-fix-language-not-supported | Fix op basis van regels: de taal van het bestand wordt niet ondersteund |
rule-fix-path-refused | Fix op basis van regels: AutoFix wijzigt dit bestand nooit |
rule-fix-pr-finding | Fix op basis van regels: de bevinding komt uit een pull request |
429 Too Many Requests
Je hebt een rate limit overschreden.
| Fouttype | |
|---|---|
rate-limited | Rate limit bereikt |
rate-limited-global | Globale rate limit bereikt |
rule-fix-org-daily-limit | Fix op basis van regels: de organisatie heeft haar dagelijkse AutoFix-limiet bereikt |
rule-fix-rate-limited | Fix op basis van regels: er is onlangs al een fix geprobeerd |
rule-fix-repo-limit | Fix op basis van regels: de repository heeft te veel open AutoFix-pull-requests |
500 Internal Server Error
Er ging iets mis aan onze kant.
| Fouttype | |
|---|---|
db-error | Databasefout |
insert-failed | Invoegen mislukt |
internal | Intern |
internal-error | Interne fout |
rate-limit-misconfigured | Rate limit verkeerd geconfigureerd |
sign-failed | Ondertekenen mislukt |
501 Not Implemented
Nog niet geïmplementeerd.
| Fouttype | |
|---|---|
not-implemented-yet | Nog niet geïmplementeerd |
502 Bad Gateway
Een upstream-afhankelijkheid gaf een fout terug.
| Fouttype | |
|---|---|
approve-failed | Goedkeuren mislukt |
ci-bot-mint-failed | Aanmaken van CI-bot mislukt |
ci-bot-revoke-failed | Intrekken van CI-bot mislukt |
forgejo-error | Forgejo-fout |
forgejo-failed | Forgejo mislukt |
forgejo-upstream-error | Upstreamfout van Forgejo |
install-failed | Installatie mislukt |
mollie-error | Mollie-fout |
mollie-unavailable | Mollie niet beschikbaar |
obs-put-failed | Opslaan in OBS mislukt |
pr-open-failed | Openen van pull request mislukt |
provisioning-failed | Provisioning mislukt |
remove-failed | Verwijderen mislukt |
revoke-failed | Intrekken mislukt |
test-failed | Test mislukt |
upstream-auth-failed | Upstream-authenticatie mislukt |
upstream-error | Upstreamfout |
upstream-unreachable | Upstream onbereikbaar |
503 Service Unavailable
Een afhankelijkheid is tijdelijk niet beschikbaar.
| Fouttype | |
|---|---|
ai-disabled | AI uitgeschakeld |
attestations-disabled | Attestaties uitgeschakeld |
billing-unavailable | Facturatie niet beschikbaar |
ci-bots-unavailable | CI-bots niet beschikbaar |
forgejo-not-configured | Forgejo niet geconfigureerd |
forgejo-proxy-disabled | Forgejo-proxy uitgeschakeld |
forgejo-unavailable | Forgejo niet beschikbaar |
forgejo-unreachable | Forgejo onbereikbaar |
invitations-unavailable | Uitnodigingen niet beschikbaar |
not-configured | Niet geconfigureerd |
ownership-unverifiable | Eigendom niet te verifiëren |
renovate-disabled | Renovate uitgeschakeld |
rule-fix-unavailable | Fix op basis van regels: fixes op basis van regels zijn niet geconfigureerd |
sbom-ingest-unavailable | SBOM-import niet beschikbaar |
seat-change-unavailable | Wijzigen van gebruikers niet beschikbaar |
seat-holds-unavailable | Gebruikersreserveringen niet beschikbaar |
secrets-unavailable | Secrets niet beschikbaar |
siem-unavailable | SIEM niet beschikbaar |
token-exchange-disabled | Token-uitwisseling uitgeschakeld |
Weigeringen van beveiligingsfixes en AI-fixes
Sinds 2026-10-14 geeft POST /orgs/{org}/dependency-updates/security-fixes/requests deze terug als security-fix-<reason> en POST /orgs/{org}/code-security/sast/findings/{id}/ai-fix als ai-fix-<reason>; elke pagina hieronder behandelt beide spellingen. De verouderde paden blijven tot 2027-10-15 autofix-<reason> teruggeven. Teruggegeven door 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 en POST /orgs/{org}/code-security/sast/findings/{id}/autofix wanneer er geen pull request wordt aangevraagd. Zie Beveiligingsfixes.
Weigeringen bij het wisselen van de beveiligingsbaan
Teruggegeven door PUT /orgs/{org}/dependency-updates/security-fixes/lane wanneer de baan Beveiligingsfixes het niet kan overnemen van gehost Renovate. Zie Overnemen van Renovate.
| Fouttype | Status |
|---|---|
security-lane-lane-off | 409 |
security-lane-unsupported-ecosystems | 409 |