Gitea organization API

openapi: 3.2.0
info:
  description: This documentation describes the Gitea API.
  title: Gitea admin Organization API
  license:
    name: MIT
    url: http://opensource.org/licenses/MIT
  version: 1.27.0+dev-89-gf52b6f3315
servers:
- url: /api/v1
security:
- BasicAuth: []
- Token: []
- AccessToken: []
- AuthorizationHeaderToken: []
- SudoParam: []
- SudoHeader: []
- TOTPHeader: []
tags:
- name: organization
paths:
  /org/{org}/repos:
    post:
      tags:
      - organization
      summary: Create a repository in an organization
      operationId: createOrgRepoDeprecated
      deprecated: true
      parameters:
      - description: name of organization
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          $ref: '#/components/responses/Repository'
        '403':
          $ref: '#/components/responses/forbidden'
        '404':
          $ref: '#/components/responses/notFound'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateRepoOption'
  /orgs:
    get:
      tags:
      - organization
      summary: Get list of organizations
      operationId: orgGetAll
      parameters:
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/OrganizationList'
    post:
      tags:
      - organization
      summary: Create an organization
      operationId: orgCreate
      responses:
        '201':
          $ref: '#/components/responses/Organization'
        '403':
          $ref: '#/components/responses/forbidden'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrgOption'
        required: true
  /orgs/{org}:
    get:
      tags:
      - organization
      summary: Get an organization
      operationId: orgGet
      parameters:
      - description: name of the organization to get
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/Organization'
        '404':
          $ref: '#/components/responses/notFound'
    delete:
      tags:
      - organization
      summary: Delete an organization
      operationId: orgDelete
      parameters:
      - description: organization that is to be deleted
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '404':
          $ref: '#/components/responses/notFound'
    patch:
      tags:
      - organization
      summary: Edit an organization
      operationId: orgEdit
      parameters:
      - description: name of the organization to edit
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/Organization'
        '404':
          $ref: '#/components/responses/notFound'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditOrgOption'
        required: true
  /orgs/{org}/actions/jobs:
    get:
      tags:
      - organization
      summary: Get org-level workflow jobs
      operationId: getOrgWorkflowJobs
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: workflow status (pending, queued, in_progress, failure, success, skipped)
        name: status
        in: query
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/WorkflowJobsList'
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/actions/runners:
    get:
      tags:
      - organization
      summary: Get org-level runners
      operationId: getOrgRunners
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: filter by disabled status (true or false)
        name: disabled
        in: query
        schema:
          type: boolean
      responses:
        '200':
          $ref: '#/components/responses/RunnerList'
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/actions/runners/registration-token:
    post:
      tags:
      - organization
      summary: Get an organization's actions runner registration token
      operationId: orgCreateRunnerRegistrationToken
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/RegistrationToken'
  /orgs/{org}/actions/runners/{runner_id}:
    get:
      tags:
      - organization
      summary: Get an org-level runner
      operationId: getOrgRunner
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the runner
        name: runner_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/Runner'
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
    delete:
      tags:
      - organization
      summary: Delete an org-level runner
      operationId: deleteOrgRunner
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the runner
        name: runner_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: runner has been deleted
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
    patch:
      tags:
      - organization
      summary: Update an org-level runner
      operationId: updateOrgRunner
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the runner
        name: runner_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/Runner'
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditActionRunnerOption'
  /orgs/{org}/actions/runs:
    get:
      tags:
      - organization
      summary: Get org-level workflow runs
      operationId: getOrgWorkflowRuns
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: workflow event name
        name: event
        in: query
        schema:
          type: string
      - description: workflow branch
        name: branch
        in: query
        schema:
          type: string
      - description: workflow status (pending, queued, in_progress, failure, success, skipped)
        name: status
        in: query
        schema:
          type: string
      - description: triggered by user
        name: actor
        in: query
        schema:
          type: string
      - description: triggering sha of the workflow run
        name: head_sha
        in: query
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/WorkflowRunsList'
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/actions/secrets:
    get:
      tags:
      - organization
      summary: List an organization's actions secrets
      operationId: orgListActionsSecrets
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/SecretList'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/actions/secrets/{secretname}:
    put:
      tags:
      - organization
      summary: Create or Update a secret value in an organization
      operationId: updateOrgSecret
      parameters:
      - description: name of organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: name of the secret
        name: secretname
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: response when creating a secret
        '204':
          description: response when updating a secret
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrUpdateSecretOption'
    delete:
      tags:
      - organization
      summary: Delete a secret in an organization
      operationId: deleteOrgSecret
      parameters:
      - description: name of organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: name of the secret
        name: secretname
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: delete one secret of the organization
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/actions/variables:
    get:
      tags:
      - organization
      summary: Get an org-level variables list
      operationId: getOrgVariablesList
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/VariableList'
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/actions/variables/{variablename}:
    get:
      tags:
      - organization
      summary: Get an org-level variable
      operationId: getOrgVariable
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: name of the variable
        name: variablename
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/ActionVariable'
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
    put:
      tags:
      - organization
      summary: Update an org-level variable
      operationId: updateOrgVariable
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: name of the variable
        name: variablename
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: response when updating an org-level variable
        '204':
          description: response when updating an org-level variable
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateVariableOption'
    post:
      tags:
      - organization
      summary: Create an org-level variable
      operationId: createOrgVariable
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: name of the variable
        name: variablename
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: successfully created the org-level variable
        '400':
          $ref: '#/components/responses/error'
        '409':
          description: variable name already exists.
        '500':
          $ref: '#/components/responses/error'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateVariableOption'
    delete:
      tags:
      - organization
      summary: Delete an org-level variable
      operationId: deleteOrgVariable
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: name of the variable
        name: variablename
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/ActionVariable'
        '201':
          description: response when deleting a variable
        '204':
          description: response when deleting a variable
        '400':
          $ref: '#/components/responses/error'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/activities/feeds:
    get:
      tags:
      - organization
      summary: List an organization's activity feeds
      operationId: orgListActivityFeeds
      parameters:
      - description: name of the org
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: the date of the activities to be found
        name: date
        in: query
        schema:
          type: string
          format: date
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/ActivityFeedsList'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/avatar:
    post:
      tags:
      - organization
      summary: Update Avatar
      operationId: orgUpdateAvatar
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '404':
          $ref: '#/components/responses/notFound'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateUserAvatarOption'
    delete:
      tags:
      - organization
      summary: Delete Avatar
      operationId: orgDeleteAvatar
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/blocks:
    get:
      tags:
      - organization
      summary: List users blocked by the organization
      operationId: organizationListBlocks
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/UserList'
  /orgs/{org}/blocks/{username}:
    get:
      tags:
      - organization
      summary: Check if a user is blocked by the organization
      operationId: organizationCheckUserBlock
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: username of the user to check
        name: username
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '404':
          $ref: '#/components/responses/notFound'
    put:
      tags:
      - organization
      summary: Block a user
      operationId: organizationBlockUser
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: username of the user to block
        name: username
        in: path
        required: true
        schema:
          type: string
      - description: optional note for the block
        name: note
        in: query
        schema:
          type: string
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '404':
          $ref: '#/components/responses/notFound'
        '422':
          $ref: '#/components/responses/validationError'
    delete:
      tags:
      - organization
      summary: Unblock a user
      operationId: organizationUnblockUser
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: username of the user to unblock
        name: username
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '404':
          $ref: '#/components/responses/notFound'
        '422':
          $ref: '#/components/responses/validationError'
  /orgs/{org}/hooks:
    get:
      tags:
      - organization
      summary: List an organization's webhooks
      operationId: orgListHooks
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/HookList'
        '404':
          $ref: '#/components/responses/notFound'
    post:
      tags:
      - organization
      summary: Create a hook
      operationId: orgCreateHook
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          $ref: '#/components/responses/Hook'
        '404':
          $ref: '#/components/responses/notFound'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateHookOption'
        required: true
  /orgs/{org}/hooks/{id}:
    get:
      tags:
      - organization
      summary: Get a hook
      operationId: orgGetHook
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the hook to get
        name: id
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          $ref: '#/components/responses/Hook'
        '404':
          $ref: '#/components/responses/notFound'
    delete:
      tags:
      - organization
      summary: Delete a hook
      operationId: orgDeleteHook
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the hook to delete
        name: id
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '404':
          $ref: '#/components/responses/notFound'
    patch:
      tags:
      - organization
      summary: Update a hook
      operationId: orgEditHook
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the hook to update
        name: id
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          $ref: '#/components/responses/Hook'
        '404':
          $ref: '#/components/responses/notFound'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditHookOption'
  /orgs/{org}/labels:
    get:
      tags:
      - organization
      summary: List an organization's labels
      operationId: orgListLabels
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/LabelList'
        '404':
          $ref: '#/components/responses/notFound'
    post:
      tags:
      - organization
      summary: Create a label for an organization
      operationId: orgCreateLabel
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          $ref: '#/components/responses/Label'
        '404':
          $ref: '#/components/responses/notFound'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateLabelOption'
  /orgs/{org}/labels/{id}:
    get:
      tags:
      - organization
      summary: Get a single label
      operationId: orgGetLabel
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the label to get
        name: id
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          $ref: '#/components/responses/Label'
        '404':
          $ref: '#/components/responses/notFound'
    delete:
      tags:
      - organization
      summary: Delete a label
      operationId: orgDeleteLabel
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the label to delete
        name: id
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '404':
          $ref: '#/components/responses/notFound'
    patch:
      tags:
      - organization
      summary: Update a label
      operationId: orgEditLabel
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: id of the label to edit
        name: id
        in: path
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          $ref: '#/components/responses/Label'
        '404':
          $ref: '#/components/responses/notFound'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditLabelOption'
  /orgs/{org}/members:
    get:
      tags:
      - organization
      summary: List an organization's members
      operationId: orgListMembers
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/UserList'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/members/{username}:
    get:
      tags:
      - organization
      summary: Check if a user is a member of an organization
      operationId: orgIsMember
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: username of the user to check for an organization membership
        name: username
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: user is a member
        '303':
          description: redirection to /orgs/{org}/public_members/{username}
        '404':
          description: user is not a member
    delete:
      tags:
      - organization
      summary: Remove a member from an organization
      operationId: orgDeleteMember
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: username of the user to remove from the organization
        name: username
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: member removed
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/public_members:
    get:
      tags:
      - organization
      summary: List an organization's public members
      operationId: orgListPublicMembers
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size of results
        name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          $ref: '#/components/responses/UserList'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/public_members/{username}:
    get:
      tags:
      - organization
      summary: Check if a user is a public member of an organization
      operationId: orgIsPublicMember
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: username of the user to check for a public organization membership
        name: username
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: user is a public member
        '404':
          description: user is not a public member
    put:
      tags:
      - organization
      summary: Publicize a user's membership
      operationId: orgPublicizeMember
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: username of the user whose membership is to be publicized
        name: username
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: membership publicized
        '403':
          $ref: '#/components/responses/forbidden'
        '404':
          $ref: '#/components/responses/notFound'
    delete:
      tags:
      - organization
      summary: Conceal a user's membership
      operationId: orgConcealMember
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: username of the user whose membership is to be concealed
        name: username
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '403':
          $ref: '#/components/responses/forbidden'
        '404':
          $ref: '#/components/responses/notFound'
  /orgs/{org}/rename:
    post:
      tags:
      - organization
      summary: Rename an organization
      operationId: renameOrg
      parameters:
      - description: existing org name
        name: org
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          $ref: '#/components/responses/empty'
        '403':
          $ref: '#/components/responses/forbidden'
        '422':
          $ref: '#/components/responses/validationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RenameOrgOption'
        required: true
  /orgs/{org}/repos:
    get:
      tags:
      - organization
      summary: List an organization's repos
      operationId: orgListRepos
      parameters:
      - description: name of the organization
        name: org
        in: path
        required: true
        schema:
          type: string
      - description: page number of results to return (1-based)
        name: page
        in: query
        schema:
          type: integer
      - description: page size

# --- truncated at 32 KB (98 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/openapi/gitea-organization-api-openapi.yml