How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Gitea organization API

The organization API from Gitea — 37 operation(s) for organization.

Gitea organization API is one of 13 APIs that Gitea publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 32 JSON Schema definitions.

Tagged areas include Organization. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, code examples, and 32 JSON Schemas.

This API exposes 67 operations across 37 paths, and defines 41 schemas. It is described by OpenAPI 2.0, at version 1.27.0+dev-89-gf52b6f3315.

Requests are made against the base URL https://gitea.com/api/v1.

67 operations 37 paths 41 schemas 14 DELETE32 GET5 PATCH10 POST6 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.27.0+dev-89-gf52b6f3315
Base URL
https://gitea.com/api/v1
Authentication
API Key, API Key, basic, API Key, API Key, API Key, API Key
License
Resource Areas
1

Authentication & Security 7

Gitea organization API declares 7 security schemes for authenticating requests. An API key is passed in the query as access_token (AccessToken). An API key is passed in the header as Authorization (AuthorizationHeaderToken). It defines a basic scheme (BasicAuth). An API key is passed in the header as Sudo (SudoHeader). An API key is passed in the query as sudo (SudoParam). An API key is passed in the header as X-GITEA-OTP (TOTPHeader). An API key is passed in the query as token (Token). By default, every request must be authenticated.

  • AccessToken — This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.
  • AuthorizationHeaderToken — API tokens must be prepended with "token" followed by a space.
  • SudoHeader — Sudo API request as the user provided as the key. Admin privileges are required.
  • SudoParam — Sudo API request as the user provided as the key. Admin privileges are required.
  • TOTPHeader — Must be used in combination with BasicAuth if two-factor authentication is enabled.
  • Token — This authentication option is deprecated for removal in Gitea 1.23. Please use AuthorizationHeaderToken instead.

Paths & Operations 67

Across 37 paths, the API surfaces 67 operations — 14 DELETE, 32 GET, 5 PATCH, 10 POST, 6 PUT. Each is listed below with its method, path, parameters, and response codes.

organization 67
POST
/org/{org}/reposdeprecated
Create a repository in an organization
createOrgRepoDeprecated 2 params → 201403404422
GET
/orgs
Get list of organizations
orgGetAll 2 params → 200
POST
/orgs
Create an organization
orgCreate 1 param → 201403422
GET
/orgs/{org}
Get an organization
orgGet 1 param → 200404
DELETE
/orgs/{org}
Delete an organization
orgDelete 1 param → 204404
PATCH
/orgs/{org}
Edit an organization
orgEdit 2 params → 200404
GET
/orgs/{org}/actions/jobs
Get org-level workflow jobs
getOrgWorkflowJobs 4 params → 200400404
GET
/orgs/{org}/actions/runners
Get org-level runners
getOrgRunners 2 params → 200400404
POST
/orgs/{org}/actions/runners/registration-token
Get an organization's actions runner registration token
orgCreateRunnerRegistrationToken 1 param → 200
GET
/orgs/{org}/actions/runners/{runner_id}
Get an org-level runner
getOrgRunner 2 params → 200400404
DELETE
/orgs/{org}/actions/runners/{runner_id}
Delete an org-level runner
deleteOrgRunner 2 params → 204400404
PATCH
/orgs/{org}/actions/runners/{runner_id}
Update an org-level runner
updateOrgRunner 3 params → 200400404422
GET
/orgs/{org}/actions/runs
Get org-level workflow runs
getOrgWorkflowRuns 8 params → 200400404
GET
/orgs/{org}/actions/secrets
List an organization's actions secrets
orgListActionsSecrets 3 params → 200404
PUT
/orgs/{org}/actions/secrets/{secretname}
Create or Update a secret value in an organization
updateOrgSecret 3 params → 201204400404
DELETE
/orgs/{org}/actions/secrets/{secretname}
Delete a secret in an organization
deleteOrgSecret 2 params → 204400404
GET
/orgs/{org}/actions/variables
Get an org-level variables list
getOrgVariablesList 3 params → 200400404
GET
/orgs/{org}/actions/variables/{variablename}
Get an org-level variable
getOrgVariable 2 params → 200400404
PUT
/orgs/{org}/actions/variables/{variablename}
Update an org-level variable
updateOrgVariable 3 params → 201204400404
POST
/orgs/{org}/actions/variables/{variablename}
Create an org-level variable
createOrgVariable 3 params → 201400409500
DELETE
/orgs/{org}/actions/variables/{variablename}
Delete an org-level variable
deleteOrgVariable 2 params → 200201204400404
GET
/orgs/{org}/activities/feeds
List an organization's activity feeds
orgListActivityFeeds 4 params → 200404
POST
/orgs/{org}/avatar
Update Avatar
orgUpdateAvatar 2 params → 204404
DELETE
/orgs/{org}/avatar
Delete Avatar
orgDeleteAvatar 1 param → 204404
GET
/orgs/{org}/blocks
List users blocked by the organization
organizationListBlocks 3 params → 200
GET
/orgs/{org}/blocks/{username}
Check if a user is blocked by the organization
organizationCheckUserBlock 2 params → 204404
PUT
/orgs/{org}/blocks/{username}
Block a user
organizationBlockUser 3 params → 204404422
DELETE
/orgs/{org}/blocks/{username}
Unblock a user
organizationUnblockUser 2 params → 204404422
GET
/orgs/{org}/hooks
List an organization's webhooks
orgListHooks 3 params → 200404
POST
/orgs/{org}/hooks
Create a hook
orgCreateHook 2 params → 201404
GET
/orgs/{org}/hooks/{id}
Get a hook
orgGetHook 2 params → 200404
DELETE
/orgs/{org}/hooks/{id}
Delete a hook
orgDeleteHook 2 params → 204404
PATCH
/orgs/{org}/hooks/{id}
Update a hook
orgEditHook 3 params → 200404
GET
/orgs/{org}/labels
List an organization's labels
orgListLabels 3 params → 200404
POST
/orgs/{org}/labels
Create a label for an organization
orgCreateLabel 2 params → 201404422
GET
/orgs/{org}/labels/{id}
Get a single label
orgGetLabel 2 params → 200404
DELETE
/orgs/{org}/labels/{id}
Delete a label
orgDeleteLabel 2 params → 204404
PATCH
/orgs/{org}/labels/{id}
Update a label
orgEditLabel 3 params → 200404422
GET
/orgs/{org}/members
List an organization's members
orgListMembers 3 params → 200404
GET
/orgs/{org}/members/{username}
Check if a user is a member of an organization
orgIsMember 2 params → 204303404
DELETE
/orgs/{org}/members/{username}
Remove a member from an organization
orgDeleteMember 2 params → 204404
GET
/orgs/{org}/public_members
List an organization's public members
orgListPublicMembers 3 params → 200404
GET
/orgs/{org}/public_members/{username}
Check if a user is a public member of an organization
orgIsPublicMember 2 params → 204404
PUT
/orgs/{org}/public_members/{username}
Publicize a user's membership
orgPublicizeMember 2 params → 204403404
DELETE
/orgs/{org}/public_members/{username}
Conceal a user's membership
orgConcealMember 2 params → 204403404
POST
/orgs/{org}/rename
Rename an organization
renameOrg 2 params → 204403422
GET
/orgs/{org}/repos
List an organization's repos
orgListRepos 3 params → 200404
POST
/orgs/{org}/repos
Create a repository in an organization
createOrgRepo 2 params → 201400403404
DELETE
/orgs/{org}/repos
Delete all repositories in an organization
orgDeleteRepos 1 param → 202204403404
GET
/orgs/{org}/teams
List an organization's teams
orgListTeams 3 params → 200404
POST
/orgs/{org}/teams
Create a team
orgCreateTeam 2 params → 201404422
GET
/orgs/{org}/teams/search
Search for teams within an organization
teamSearch 5 params → 200404
GET
/teams/{id}
Get a team
orgGetTeam 1 param → 200404
DELETE
/teams/{id}
Delete a team
orgDeleteTeam 1 param → 204404
PATCH
/teams/{id}
Edit a team
orgEditTeam 2 params → 200404
GET
/teams/{id}/activities/feeds
List a team's activity feeds
orgListTeamActivityFeeds 4 params → 200404
GET
/teams/{id}/members
List a team's members
orgListTeamMembers 3 params → 200404
GET
/teams/{id}/members/{username}
List a particular member of team
orgListTeamMember 2 params → 200404
PUT
/teams/{id}/members/{username}
Add a team member
orgAddTeamMember 2 params → 204403404
DELETE
/teams/{id}/members/{username}
Remove a team member
orgRemoveTeamMember 2 params → 204404
GET
/teams/{id}/repos
List a team's repos
orgListTeamRepos 3 params → 200404
GET
/teams/{id}/repos/{org}/{repo}
List a particular repo of team
orgListTeamRepo 3 params → 200404
PUT
/teams/{id}/repos/{org}/{repo}
Add a repository to a team
orgAddTeamRepository 3 params → 204403404
DELETE
/teams/{id}/repos/{org}/{repo}
Remove a repository from a team
orgRemoveTeamRepository 3 params → 204403404
GET
/user/orgs
List the current user's organizations
orgListCurrentUserOrgs 2 params → 200404
GET
/users/{username}/orgs
List a user's organizations
orgListUserOrgs 3 params → 200404
GET
/users/{username}/orgs/{org}/permissions
Get user permissions in organization
orgGetUserPermissions 2 params → 200403404

Schemas 41

The contract defines 41 schemas that model the data the API accepts and returns. The most detailed are Repository (67 properties), User (22 properties), ActionWorkflowRun (19 properties), ActionWorkflowJob (18 properties). Each schema is shown below with its type and property counts.

ActionRunnersResponse
object
ActionRunnersResponse returns Runners
2 properties
CreateLabelOption
object
CreateLabelOption options for creating a label
5 properties 2 required
CreateOrUpdateSecretOption
object
CreateOrUpdateSecretOption options when creating or updating secret
2 properties 1 required
ActionRunner
object
ActionRunner represents a Runner
7 properties
OrganizationPermissions
object
OrganizationPermissions list different users permissions on an organization
5 properties
CreateHookOption
object
CreateHookOption options when create a hook
7 properties 2 required
UpdateVariableOption
object
UpdateVariableOption the option when updating variable
3 properties 1 required
RenameOrgOption
object
RenameOrgOption options when renaming an organization
1 property 1 required
User
object
User represents a user
22 properties
CreateVariableOption
object
CreateVariableOption the option when creating variable
2 properties 1 required
EditLabelOption
object
EditLabelOption options for editing a label
5 properties
ActionWorkflowJobsResponse
object
ActionWorkflowJobsResponse returns ActionWorkflowJobs
2 properties
Hook
object
Hook a hook is a web hook when one repository changed
10 properties
ActionRunnerLabel
object
ActionRunnerLabel represents a Runner Label
3 properties
UpdateUserAvatarOption
object
UpdateUserAvatarUserOption options when updating the user avatar
1 property
Secret
object
Secret represents a secret
3 properties
CreateOrgOption
object
CreateOrgOption options for creating an organization
8 properties 1 required
RepoTransfer
object
RepoTransfer represents a pending repo transfer
3 properties
CreateTeamOption
object
CreateTeamOption options for creating a team
7 properties 1 required
EditOrgOption
object
EditOrgOption options for editing an organization
7 properties
ActionWorkflowStep
object
ActionWorkflowStep represents a step of a WorkflowJob
6 properties
Activity
object
13 properties
ActionWorkflowJob
object
ActionWorkflowJob represents a WorkflowJob
18 properties
ActionVariable
object
ActionVariable return value of the query API
5 properties
InternalTracker
object
InternalTracker represents settings for internal tracker
3 properties
Team
object
Team represents a team in an organization
9 properties
Attachment
object
Attachment a generic attachment
7 properties
CreateRepoOption
object
CreateRepoOption options when creating repository
12 properties 1 required
Permission
object
Permission represents a set of permissions
3 properties
EditTeamOption
object
EditTeamOption options for editing a team
7 properties 1 required
ActionWorkflowRunsResponse
object
ActionWorkflowRunsResponse returns ActionWorkflowRuns
2 properties
CreateHookOptionConfig
object
CreateHookOptionConfig has all config options in it required are "contenttype" and "url" Required
ActionWorkflowRun
object
ActionWorkflowRun represents a WorkflowRun
19 properties
ExternalWiki
object
ExternalWiki represents setting for external wiki
1 property
EditActionRunnerOption
object
1 property 1 required
Organization
object
Organization represents an organization
11 properties
EditHookOption
object
EditHookOption options when modify one hook
6 properties
ExternalTracker
object
ExternalTracker represents settings for external tracker
4 properties
Repository
object
Repository represents a repository
67 properties
Comment
object
Comment represents a comment on a commit or issue
11 properties
Label
object
Label a label to an issue or a pr
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

gitea-organization-api-openapi.yml Raw ↑

Other APIs Gitea publishes across the network.

Gitea Actions API
Gitea Package Registry
Gitea Webhooks
Gitea Cloud Management API
Gitea admin API
Gitea issue API
Gitea miscellaneous API
Gitea notification API
Gitea package API
Gitea repository API
Gitea settings API
Gitea user API
Where this information came from

This is an independent, third-party profile of Gitea organization API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.