Gitea API — user

naftiko: 1.0.0-alpha2
info:
  label: Gitea API — user
  description: 'Gitea API — user. 76 operations. Lead operation: Get the Authenticated User. Self-contained Naftiko capability
    covering one Gitea business surface.'
  tags:
  - Gitea
  - user
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    GITEA_API_KEY: GITEA_API_KEY
capability:
  consumes:
  - type: http
    namespace: rest-user
    baseUri: https://gitea.com/api/v1
    description: Gitea API — user business capability. Self-contained, no shared references.
    resources:
    - name: user
      path: /user
      operations:
      - name: usergetcurrent
        method: GET
        description: Get the Authenticated User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: user-actions-jobs
      path: /user/actions/jobs
      operations:
      - name: getuserworkflowjobs
        method: GET
        description: Get Workflow Jobs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: status
          in: query
          type: string
          description: workflow status (pending, queued, in_progress, failure, success, skipped)
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-actions-runners
      path: /user/actions/runners
      operations:
      - name: getuserrunners
        method: GET
        description: Get User-Level Runners
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: disabled
          in: query
          type: boolean
          description: filter by disabled status (true or false)
    - name: user-actions-runners-registration-token
      path: /user/actions/runners/registration-token
      operations:
      - name: usercreaterunnerregistrationtoken
        method: POST
        description: Get a User's Actions Runner Registration Token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: user-actions-runners-runner_id
      path: /user/actions/runners/{runner_id}
      operations:
      - name: getuserrunner
        method: GET
        description: Get a User-Level Runner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: runner_id
          in: path
          type: string
          description: id of the runner
          required: true
      - name: deleteuserrunner
        method: DELETE
        description: Delete a User-Level Runner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: runner_id
          in: path
          type: string
          description: id of the runner
          required: true
      - name: updateuserrunner
        method: PATCH
        description: Update a User-Level Runner
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: runner_id
          in: path
          type: string
          description: id of the runner
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-actions-runs
      path: /user/actions/runs
      operations:
      - name: getuserworkflowruns
        method: GET
        description: Get Workflow Runs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: event
          in: query
          type: string
          description: workflow event name
        - name: branch
          in: query
          type: string
          description: workflow branch
        - name: status
          in: query
          type: string
          description: workflow status (pending, queued, in_progress, failure, success, skipped)
        - name: actor
          in: query
          type: string
          description: triggered by user
        - name: head_sha
          in: query
          type: string
          description: triggering sha of the workflow run
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-actions-secrets-secretname
      path: /user/actions/secrets/{secretname}
      operations:
      - name: updateusersecret
        method: PUT
        description: Create or Update a Secret Value in a User Scope
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: secretname
          in: path
          type: string
          description: name of the secret
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteusersecret
        method: DELETE
        description: Delete a Secret in a User Scope
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: secretname
          in: path
          type: string
          description: name of the secret
          required: true
    - name: user-actions-variables
      path: /user/actions/variables
      operations:
      - name: getuservariableslist
        method: GET
        description: Get the User-Level List of Variables Which Is Created by Current Doer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-actions-variables-variablename
      path: /user/actions/variables/{variablename}
      operations:
      - name: getuservariable
        method: GET
        description: Get a User-Level Variable Which Is Created by Current Doer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: variablename
          in: path
          type: string
          description: name of the variable
          required: true
      - name: updateuservariable
        method: PUT
        description: Update a User-Level Variable Which Is Created by Current Doer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: variablename
          in: path
          type: string
          description: name of the variable
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: createuservariable
        method: POST
        description: Create a User-Level Variable
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: variablename
          in: path
          type: string
          description: name of the variable
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteuservariable
        method: DELETE
        description: Delete a User-Level Variable Which Is Created by Current Doer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: variablename
          in: path
          type: string
          description: name of the variable
          required: true
    - name: user-applications-oauth2
      path: /user/applications/oauth2
      operations:
      - name: usergetoauth2application
        method: GET
        description: List the Authenticated User's OAuth2 Applications
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
      - name: usercreateoauth2application
        method: POST
        description: Creates a New OAuth2 Application
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-applications-oauth2-id
      path: /user/applications/oauth2/{id}
      operations:
      - name: usergetoauth2application
        method: GET
        description: Get an OAuth2 Application
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: Application ID to be found
          required: true
      - name: userdeleteoauth2application
        method: DELETE
        description: Delete an OAuth2 Application
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: token to be deleted
          required: true
      - name: userupdateoauth2application
        method: PATCH
        description: Update an OAuth2 Application, This Includes Regenerating the Client Secret
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: application to be updated
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-avatar
      path: /user/avatar
      operations:
      - name: userupdateavatar
        method: POST
        description: Update Avatar
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: userdeleteavatar
        method: DELETE
        description: Delete Avatar
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: user-blocks
      path: /user/blocks
      operations:
      - name: userlistblocks
        method: GET
        description: List Users Blocked by the Authenticated User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-blocks-username
      path: /user/blocks/{username}
      operations:
      - name: usercheckuserblock
        method: GET
        description: Check if a User Is Blocked by the Authenticated User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: username
          in: path
          type: string
          description: username of the user to check
          required: true
      - name: userblockuser
        method: PUT
        description: Block a User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: username
          in: path
          type: string
          description: username of the user to block
          required: true
        - name: note
          in: query
          type: string
          description: optional note for the block
      - name: userunblockuser
        method: DELETE
        description: Unblock a User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: username
          in: path
          type: string
          description: username of the user to unblock
          required: true
    - name: user-emails
      path: /user/emails
      operations:
      - name: userlistemails
        method: GET
        description: List the Authenticated User's Email Addresses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: useraddemail
        method: POST
        description: Add Email Addresses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: userdeleteemail
        method: DELETE
        description: Delete Email Addresses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-followers
      path: /user/followers
      operations:
      - name: usercurrentlistfollowers
        method: GET
        description: List the Authenticated User's Followers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-following
      path: /user/following
      operations:
      - name: usercurrentlistfollowing
        method: GET
        description: List the Users That the Authenticated User Is Following
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-following-username
      path: /user/following/{username}
      operations:
      - name: usercurrentcheckfollowing
        method: GET
        description: Check Whether a User Is Followed by the Authenticated User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: username
          in: path
          type: string
          description: username of the user to check for authenticated followers
          required: true
      - name: usercurrentputfollow
        method: PUT
        description: Follow a User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: username
          in: path
          type: string
          description: username of the user to follow
          required: true
      - name: usercurrentdeletefollow
        method: DELETE
        description: Unfollow a User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: username
          in: path
          type: string
          description: username of the user to unfollow
          required: true
    - name: user-gpg_key_token
      path: /user/gpg_key_token
      operations:
      - name: getverificationtoken
        method: GET
        description: Get a Token to Verify
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: user-gpg_key_verify
      path: /user/gpg_key_verify
      operations:
      - name: userverifygpgkey
        method: POST
        description: Verify a GPG Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: user-gpg_keys
      path: /user/gpg_keys
      operations:
      - name: usercurrentlistgpgkeys
        method: GET
        description: List the Authenticated User's GPG Keys
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
      - name: usercurrentpostgpgkey
        method: POST
        description: Create a GPG Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-gpg_keys-id
      path: /user/gpg_keys/{id}
      operations:
      - name: usercurrentgetgpgkey
        method: GET
        description: Get a GPG Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id of key to get
          required: true
      - name: usercurrentdeletegpgkey
        method: DELETE
        description: Remove a GPG Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id of key to delete
          required: true
    - name: user-hooks
      path: /user/hooks
      operations:
      - name: userlisthooks
        method: GET
        description: List the Authenticated User's Webhooks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
      - name: usercreatehook
        method: POST
        description: Create a Hook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-hooks-id
      path: /user/hooks/{id}
      operations:
      - name: usergethook
        method: GET
        description: Get a Hook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id of the hook to get
          required: true
      - name: userdeletehook
        method: DELETE
        description: Delete a Hook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id of the hook to delete
          required: true
      - name: useredithook
        method: PATCH
        description: Update a Hook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id of the hook to update
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-keys
      path: /user/keys
      operations:
      - name: usercurrentlistkeys
        method: GET
        description: List the Authenticated User's Public Keys
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fingerprint
          in: query
          type: string
          description: fingerprint of the key
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
      - name: usercurrentpostkey
        method: POST
        description: Create a Public Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-keys-id
      path: /user/keys/{id}
      operations:
      - name: usercurrentgetkey
        method: GET
        description: Get a Public Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id of key to get
          required: true
      - name: usercurrentdeletekey
        method: DELETE
        description: Delete a Public Key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: integer
          description: id of key to delete
          required: true
    - name: user-repos
      path: /user/repos
      operations:
      - name: usercurrentlistrepos
        method: GET
        description: List the Repos That the Authenticated User Owns
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
      - name: createcurrentuserrepo
        method: POST
        description: Create a Repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-settings
      path: /user/settings
      operations:
      - name: getusersettings
        method: GET
        description: Get User Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateusersettings
        method: PATCH
        description: Update User Settings
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: user-starred
      path: /user/starred
      operations:
      - name: usercurrentliststarred
        method: GET
        description: The Repos That the Authenticated User Has Starred
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-starred-owner-repo
      path: /user/starred/{owner}/{repo}
      operations:
      - name: usercurrentcheckstarring
        method: GET
        description: Whether the Authenticated Is Starring the Repo
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: owner
          in: path
          type: string
          description: owner of the repo
          required: true
        - name: repo
          in: path
          type: string
          description: name of the repo
          required: true
      - name: usercurrentputstar
        method: PUT
        description: Star the Given Repo
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: owner
          in: path
          type: string
          description: owner of the repo to star
          required: true
        - name: repo
          in: path
          type: string
          description: name of the repo to star
          required: true
      - name: usercurrentdeletestar
        method: DELETE
        description: Unstar the Given Repo
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: owner
          in: path
          type: string
          description: owner of the repo to unstar
          required: true
        - name: repo
          in: path
          type: string
          description: name of the repo to unstar
          required: true
    - name: user-stopwatches
      path: /user/stopwatches
      operations:
      - name: usergetstopwatches
        method: GET
        description: Get List of All Existing Stopwatches
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-subscriptions
      path: /user/subscriptions
      operations:
      - name: usercurrentlistsubscriptions
        method: GET
        description: List Repositories Watched by the Authenticated User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-teams
      path: /user/teams
      operations:
      - name: userlistteams
        method: GET
        description: List All the Teams a User Belongs To
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: user-times
      path: /user/times
      operations:
      - name: usercurrenttrackedtimes
        method: GET
        description: List the Current User's Tracked Times
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
        - name: since
          in: query
          type: string
          description: Only show times updated after the given time. This is a timestamp in RFC 3339 format
        - name: before
          in: query
          type: string
          description: Only show times updated before the given time. This is a timestamp in RFC 3339 format
    - name: users-search
      path: /users/search
      operations:
      - name: usersearch
        method: GET
        description: Search for Users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: q
          in: query
          type: string
          description: keyword
        - name: uid
          in: query
          type: integer
          description: ID of the user to search for
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: users-username
      path: /users/{username}
      operations:
      - name: userget
        method: GET
        description: Get a User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: username
          in: path
          type: string
          description: username of the user whose data is to be listed
          required: true
    - name: users-username-activities-feeds
      path: /users/{username}/activities/feeds
      operations:
      - name: userlistactivityfeeds
        method: GET
        description: List a User's Activity Feeds
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: username
          in: path
          type: string
          description: username of the user whose activity feeds are to be listed
          required: true
        - name: only-performed-by
          in: query
          type: boolean
          description: if true, only show actions performed by the requested user
        - name: date
          in: query
          type: string
          description: the date of the activities to be found
        - name: page
          in: query
          type: integer
          description: page number of results to return (1-based)
        - name: limit
          in: query
          type: integer
          description: page size of results
    - name: users-username-followers
      path: /users/{username}/followers
      operations:
      - name: userlistfollowers
        method: GET
        description: List the Given User's Followers
        outputRawFormat: json
        

# --- truncated at 32 KB (93 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/capabilities/rest-user.yaml