Forgejo
Forgejo is a self-hosted lightweight software forge and open-source Git service (a Gitea fork) managed by the non-profit Codeberg e.V. It provides a comprehensive REST API for managing repositories, users, organizations, issues, pull requests, CI/CD workflows via Actions, and package registries. Forgejo emphasizes privacy, low resource usage, and community ownership as a Free Software alternative to centralized code hosting platforms.
Limited machine-readable signal and partial portal coverage — documentation a human can read, but little a machine or agent can consume without scraping.
API Evangelist profiles Forgejo the way a machine reads it — 279 machine-readable artifacts across 10 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.
Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — Forgejo scores 43.3/100 (thin), with a separate agent-readiness read of 48/100 (agent ready). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.
Kin Score
This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.
Kin Score
How this is scored →scored 2026-07-27 · rubric v0.5
How we profile Forgejo
Each block below is one kind of artifact we hold for Forgejo. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.
APIs 10
Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.
Individual APIs this provider publishes, each with its own machine-readable definition.
Forgejo activitypub API
The activitypub API from Forgejo — 11 operation(s) for activitypub.
Forgejo admin API
The admin API from Forgejo — 34 operation(s) for admin.
Forgejo issue API
The issue API from Forgejo — 33 operation(s) for issue.
Forgejo miscellaneous API
The miscellaneous API from Forgejo — 14 operation(s) for miscellaneous.
Forgejo notification API
The notification API from Forgejo — 4 operation(s) for notification.
Forgejo organization API
The organization API from Forgejo — 42 operation(s) for organization.
Forgejo package API
The package API from Forgejo — 5 operation(s) for package.
Forgejo repository API
The repository API from Forgejo — 126 operation(s) for repository.
Forgejo settings API
The settings API from Forgejo — 4 operation(s) for settings.
Forgejo user API
The user API from Forgejo — 54 operation(s) for user.
Scroll within the panel for all 10 ·
Pricing Plans 1
Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.
Published pricing tiers and plan structures.
Rate Limits 1
Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.
Documented rate limits and quota policies.
Forgejo Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.
Cost, billing, and metering signals for API financial operations.
Forgejo Finops
FINOPSSpectral Rules 1
Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.
Forgejo API Rules
SPECTRALJSON Schema 246
Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.
Standalone JSON Schema definitions for this provider's data models.
AccessToken represents an API access token.
JSON SCHEMAActionArtifact
JSON SCHEMAActionRun
JSON SCHEMAActionRunJob
JSON SCHEMAActionRunner
JSON SCHEMAActionTask
JSON SCHEMAActionTaskResponse
JSON SCHEMAActionVariable
JSON SCHEMAActivity
JSON SCHEMAActivityPub
JSON SCHEMAAddCollaboratorOption
JSON SCHEMAAddTimeOption
JSON SCHEMAAnnotatedTag
JSON SCHEMAAnnotatedTagObject
JSON SCHEMAAPIError
JSON SCHEMAAPIForbiddenError
JSON SCHEMAAPIInternalServerError
JSON SCHEMAAPIInvalidTopicsError
JSON SCHEMAAPINotFound
JSON SCHEMAAPIRepoArchivedError
JSON SCHEMAAPIUnauthorizedError
JSON SCHEMAAPIValidationError
JSON SCHEMAAPRemoteFollowOption
JSON SCHEMAAttachment
JSON SCHEMABlockedUser represents a blocked user.
JSON SCHEMABranch
JSON SCHEMABranchProtection
JSON SCHEMAChangedFile
JSON SCHEMAChangeFileOperation
JSON SCHEMAChangeFilesOptions
JSON SCHEMACombinedStatus
JSON SCHEMAComment
JSON SCHEMACommitAffectedFiles
JSON SCHEMACommitDateOptions
JSON SCHEMACommitStats
JSON SCHEMACommitStatus
JSON SCHEMACommitStatusState
JSON SCHEMAContentsResponse
JSON SCHEMACreateAccessTokenOption
JSON SCHEMACreateBranchProtectionOption
JSON SCHEMACreateBranchRepoOption
JSON SCHEMACreateEmailOption
JSON SCHEMACreateFileOptions
JSON SCHEMACreateForkOption
JSON SCHEMACreateGPGKeyOption
JSON SCHEMACreateHookOption
JSON SCHEMACreateHookOptionConfig
JSON SCHEMACreateIssueCommentOption
JSON SCHEMACreateIssueOption
JSON SCHEMACreateKeyOption
JSON SCHEMACreateLabelOption
JSON SCHEMACreateMilestoneOption
JSON SCHEMACreateOAuth2ApplicationOptions
JSON SCHEMACreateOrgOption
JSON SCHEMACreatePullRequestOption
JSON SCHEMACreatePullReviewComment
JSON SCHEMACreatePullReviewCommentOptions
JSON SCHEMACreatePullReviewOptions
JSON SCHEMACreatePushMirrorOption represents need information to create a push mirror of a repository.
JSON SCHEMACreateQuotaGroupOptions
JSON SCHEMACreateQuotaRuleOptions
JSON SCHEMACreateReleaseOption
JSON SCHEMACreateRepoOption
JSON SCHEMACreateStatusOption
JSON SCHEMACreateTagOption
JSON SCHEMACreateTagProtectionOption
JSON SCHEMACreateTeamOption
JSON SCHEMACreateUserOption
JSON SCHEMACreateWikiPageOptions
JSON SCHEMACron
JSON SCHEMADeleteEmailOption
JSON SCHEMADeleteFileOptions
JSON SCHEMADeleteLabelsOption
JSON SCHEMADeployKey
JSON SCHEMADismissPullReviewOptions
JSON SCHEMADispatchWorkflowOption
JSON SCHEMADispatchWorkflowRun
JSON SCHEMADuration
JSON SCHEMAEditAttachmentOptions
JSON SCHEMAEditBranchProtectionOption
JSON SCHEMAEditDeadlineOption
JSON SCHEMAEditGitHookOption
JSON SCHEMAEditHookOption
JSON SCHEMAEditIssueCommentOption
JSON SCHEMAEditIssueOption
JSON SCHEMAEditLabelOption
JSON SCHEMAEditMilestoneOption
JSON SCHEMAEditOrgOption
JSON SCHEMAEditPullRequestOption
JSON SCHEMAEditQuotaRuleOptions
JSON SCHEMAEditReactionOption
JSON SCHEMAEditReleaseOption
JSON SCHEMAEditRepoOption
JSON SCHEMAEditTagProtectionOption
JSON SCHEMAEditTeamOption
JSON SCHEMAEditUserOption
JSON SCHEMAExternalTracker
JSON SCHEMAExternalWiki
JSON SCHEMAFileDeleteResponse
JSON SCHEMAFileLinksResponse
JSON SCHEMAFileResponse
JSON SCHEMAFilesResponse
JSON SCHEMAForgeLike
JSON SCHEMAForgeOutbox
JSON SCHEMAGeneralAPISettings
JSON SCHEMAGeneralAttachmentSettings
JSON SCHEMAGeneralRepoSettings
JSON SCHEMAGeneralUISettings
JSON SCHEMAGenerateRepoOption
JSON SCHEMAGitBlob
JSON SCHEMAGitEntry
JSON SCHEMAGitHook
JSON SCHEMAGitignoreTemplateInfo
JSON SCHEMAGitObject represents a Git object.
JSON SCHEMAGitTreeResponse
JSON SCHEMAGPGKey
JSON SCHEMAGPGKeyEmail
JSON SCHEMAHook
JSON SCHEMAIdentity
JSON SCHEMAInternalTracker
JSON SCHEMAIssue
JSON SCHEMAIssueConfig
JSON SCHEMAIssueConfigContactLink
JSON SCHEMAIssueConfigValidation
JSON SCHEMAIssueDeadline
JSON SCHEMAIssueFormField
JSON SCHEMAIssueFormFieldVisible
JSON SCHEMAIssueLabelsOption
JSON SCHEMAIssueMeta
JSON SCHEMAIssueTemplate
JSON SCHEMAIssueTemplateLabels
JSON SCHEMALabel
JSON SCHEMALabelTemplate
JSON SCHEMALicensesTemplateListEntry
JSON SCHEMALicenseTemplateInfo
JSON SCHEMAListActionRunResponse
JSON SCHEMAMarkdownOption
JSON SCHEMAMarkupOption
JSON SCHEMAMergePullRequestOption
JSON SCHEMAMigrateRepoOptions
JSON SCHEMAMilestone
JSON SCHEMANewIssuePinsAllowed
JSON SCHEMANodeInfo
JSON SCHEMANodeInfoServices
JSON SCHEMANodeInfoSoftware
JSON SCHEMANodeInfoUsage
JSON SCHEMANodeInfoUsageUsers
JSON SCHEMANote
JSON SCHEMANoteOptions
JSON SCHEMANotificationCount
JSON SCHEMANotificationSubject
JSON SCHEMANotificationThread
JSON SCHEMANotifySubjectType
JSON SCHEMAOrganization
JSON SCHEMAOrganizationPermissions
JSON SCHEMAPackage
JSON SCHEMAPackageFile
JSON SCHEMAPayloadCommit
JSON SCHEMAPayloadCommitVerification
JSON SCHEMAPayloadUser
JSON SCHEMAPermission
JSON SCHEMAPRBranchInfo
JSON SCHEMAPublicKey
JSON SCHEMAPullRequest
JSON SCHEMAPullRequestMeta
JSON SCHEMAPullReview
JSON SCHEMAPullReviewComment
JSON SCHEMAPullReviewRequestOptions
JSON SCHEMAPushMirror
JSON SCHEMAQuotaGroup
JSON SCHEMAQuotaGroupList
JSON SCHEMAQuotaInfo
JSON SCHEMAQuotaRuleInfo
JSON SCHEMAQuotaUsed
JSON SCHEMAQuotaUsedArtifact
JSON SCHEMAQuotaUsedArtifactList
JSON SCHEMAQuotaUsedAttachment
JSON SCHEMAQuotaUsedAttachmentList
JSON SCHEMAQuotaUsedPackage
JSON SCHEMAQuotaUsedPackageList
JSON SCHEMAQuotaUsedSize
JSON SCHEMAQuotaUsedSizeAssets
JSON SCHEMAQuotaUsedSizeAssetsAttachments
JSON SCHEMAQuotaUsedSizeAssetsPackages
JSON SCHEMAQuotaUsedSizeGit
JSON SCHEMAQuotaUsedSizeRepos
JSON SCHEMAReaction
JSON SCHEMAReference represents a Git reference.
JSON SCHEMARegistrationToken
JSON SCHEMARelease
JSON SCHEMARenameOrgOption
JSON SCHEMARenameUserOption
JSON SCHEMAReplaceFlagsOption
JSON SCHEMARepoCollaboratorPermission
JSON SCHEMARepository
JSON SCHEMARepositoryMeta
JSON SCHEMARepoTargetOption
JSON SCHEMARepoTopicOptions
JSON SCHEMARepoTransfer
JSON SCHEMAReviewStateType
JSON SCHEMASearchResults
JSON SCHEMASecret
JSON SCHEMAServerVersion
JSON SCHEMASetUserQuotaGroupsOptions
JSON SCHEMAStateType
JSON SCHEMAStopWatch
JSON SCHEMASubmitPullReviewOptions
JSON SCHEMASyncForkInfo
JSON SCHEMATag
JSON SCHEMATagArchiveDownloadCount
JSON SCHEMATagProtection
JSON SCHEMATeam
JSON SCHEMATimelineComment
JSON SCHEMATimeStamp
JSON SCHEMATopicName
JSON SCHEMATopicResponse
JSON SCHEMATrackedTime
JSON SCHEMATransferRepoOption
JSON SCHEMAUpdateBranchRepoOption
JSON SCHEMAUpdateFileOptions
JSON SCHEMAUpdateRepoAvatarOption
JSON SCHEMAUpdateUserAvatarOption
JSON SCHEMAUser
JSON SCHEMAUserHeatmapData
JSON SCHEMAUserSettings
JSON SCHEMAUserSettingsOptions
JSON SCHEMAVerifyGPGKeyOption
JSON SCHEMAWatchInfo
JSON SCHEMAWikiCommit
JSON SCHEMAWikiCommitList
JSON SCHEMAWikiPage
JSON SCHEMAWikiPageMetaData
JSON SCHEMAScroll within the panel for all 246 ·
Examples 15
Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.
Example request and response payloads for these APIs.
Actiontask Example
EXAMPLEBranch Example
EXAMPLECommit Example
EXAMPLEHook Example
EXAMPLEIssue Example
EXAMPLELabel Example
EXAMPLEMilestone Example
EXAMPLENotificationthread Example
EXAMPLEOrganization Example
EXAMPLEPackage Example
EXAMPLEPullrequest Example
EXAMPLERelease Example
EXAMPLERepository Example
EXAMPLETeam Example
EXAMPLEUser Example
EXAMPLEScroll within the panel for all 15 ·
Security Posture 3
Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Agentic Access 1
An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.
Recommended x-agentic-access execution contracts for AI agents.
Resources
Every other property we hold for Forgejo — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.
Documentation 1
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Build 2
SDKs, sample code, and the tooling you integrate with
Access & Security 3
Authentication, authorization, and security posture
Operate 2
Status, limits, changes, and where to get help
Commercial 3
Pricing, plans, and the legal terms of use
Company 3
The organization behind the API
Other 2
Properties that don't map to a standard resource type
← All providers · Data indexed from github.com/api-evangelist/forgejo · machine-readable index on apis.io