# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Gitea User API
  version: 1.0.0
extends: openapi/gitea-user-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 76
- target: $.paths['/user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my own Gitea user profile
      effect: read
      questions:
      - Which Gitea account is my API token signed in as?
      - Can I fetch my own profile details using just my token?
      instructions:
      - text: Show me the profile of the account I'm authenticated as.
      - text: Tell me who I am logged in as on this Gitea instance.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Actions workflow jobs
      effect: read
      questions:
      - What Actions workflow jobs are running across my personal account?
      - Can I filter my own workflow jobs by status, like only failed ones?
      instructions:
      - text: List my personal Actions workflow jobs with status {status}.
        slots:
          status: query.status
      - text: Show the first {limit} workflow jobs under my user account.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/runners'].get
  update:
    x-apievangelist-phrasing:
      intent: List my user-level Actions runners
      effect: read
      questions:
      - Which Actions runners are registered to my personal account?
      - Is there a way to see only my disabled user-level runners?
      instructions:
      - text: List all the Actions runners registered at my user level.
      - text: Show my user-level runners where disabled is {disabled}.
        slots:
          disabled: query.disabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/runners/registration-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a token to register a personal runner
      effect: write
      questions:
      - How do I get a registration token to attach a runner to my own account?
      - What token does a new act runner need to join my user scope?
      instructions:
      - text: Generate a runner registration token for my user account.
      - text: Give me a token so I can register a new Actions runner under my own user.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/runners/{runner_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my user-level runners
      effect: read
      questions:
      - What are the details and status of one specific runner on my account?
      - Can I look up a single personal runner by its ID?
      instructions:
      - text: Show details for my user-level runner {runner_id}.
        slots:
          runner_id: path.runner_id
      - text: Check whether my personal runner {runner_id} is online.
        slots:
          runner_id: path.runner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/runners/{runner_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user-level runner
      effect: destructive
      questions:
      - How can I unregister a runner I no longer use from my personal account?
      - Can I delete a user-level runner permanently by ID?
      instructions:
      - text: Delete my user-level runner {runner_id}.
        slots:
          runner_id: path.runner_id
      - text: Unregister runner {runner_id} from my personal account.
        slots:
          runner_id: path.runner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/runners/{runner_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable a user-level runner
      effect: write
      questions:
      - Can I pause one of my personal runners without deleting it?
      - What's the way to re-enable a runner on my account that I disabled?
      instructions:
      - text: Set disabled to {disabled} on my user-level runner {runner_id}.
        slots:
          disabled: requestBody.disabled
          runner_id: path.runner_id
      - text: Disable my personal runner {runner_id} so it stops picking up jobs.
        slots:
          runner_id: path.runner_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/runs'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Actions workflow runs
      effect: read
      questions:
      - Which workflow runs have been triggered across my personal repos?
      - Can I filter my workflow runs by branch, event or commit SHA?
      instructions:
      - text: List my workflow runs on branch {branch} with status {status}.
        slots:
          branch: query.branch
          status: query.status
      - text: Show my workflow runs triggered by {event} for commit {head_sha}.
        slots:
          event: query.event
          head_sha: query.head_sha
      - text: Find my workflow runs started by {actor}.
        slots:
          actor: query.actor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/secrets/{secretname}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a user-level Actions secret
      effect: write
      questions:
      - How do I store a secret that all my personal repos' Actions can use?
      - Can I overwrite the value of an existing user-scope secret?
      instructions:
      - text: Save user secret {secretname} with value {data}.
        slots:
          secretname: path.secretname
          data: requestBody.data
      - text: Update my user-scope secret {secretname} to {data} with description {description}.
        slots:
          secretname: path.secretname
          data: requestBody.data
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/secrets/{secretname}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user-level Actions secret
      effect: destructive
      questions:
      - How can I remove a secret from my personal Actions scope?
      - Is it possible to delete a user-level secret by its name?
      instructions:
      - text: Delete my user-scope secret {secretname}.
        slots:
          secretname: path.secretname
      - text: Remove the Actions secret named {secretname} from my account.
        slots:
          secretname: path.secretname
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/variables'].get
  update:
    x-apievangelist-phrasing:
      intent: List my user-level Actions variables
      effect: read
      questions:
      - What Actions variables have I defined at the user level?
      - Can I page through all my personal workflow variables?
      instructions:
      - text: List all my user-level Actions variables.
      - text: Show page {page} of my user variables.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/variables/{variablename}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one user-level Actions variable
      effect: read
      questions:
      - What value is stored in one particular variable on my account?
      - Can I read a single personal Actions variable by name?
      instructions:
      - text: Show the value of my user variable {variablename}.
        slots:
          variablename: path.variablename
      - text: Get my personal Actions variable {variablename}.
        slots:
          variablename: path.variablename
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/variables/{variablename}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing user-level variable
      effect: write
      questions:
      - How do I change the value of a variable I already created on my account?
      - Can I rename an existing user-level Actions variable?
      instructions:
      - text: Change my existing user variable {variablename} to {value}.
        slots:
          variablename: path.variablename
          value: requestBody.value
      - text: Rename my user variable {variablename} to {name} and set it to {value}.
        slots:
          variablename: path.variablename
          name: requestBody.name
          value: requestBody.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/variables/{variablename}'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new user-level Actions variable
      effect: write
      questions:
      - How do I add a new workflow variable shared across my personal repos?
      - Can a new user variable carry a description too?
      instructions:
      - text: Create a new user variable {variablename} with value {value}.
        slots:
          variablename: path.variablename
          value: requestBody.value
      - text: Add user-level variable {variablename} = {value} described as {description}.
        slots:
          variablename: path.variablename
          value: requestBody.value
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/actions/variables/{variablename}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user-level Actions variable
      effect: destructive
      questions:
      - How can I remove a variable from my personal Actions scope?
      - Can I delete a user variable I created earlier?
      instructions:
      - text: Delete my user variable {variablename}.
        slots:
          variablename: path.variablename
      - text: Remove the Actions variable {variablename} from my account.
        slots:
          variablename: path.variablename
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/applications/oauth2'].get
  update:
    x-apievangelist-phrasing:
      intent: List my OAuth2 applications
      effect: read
      questions:
      - Which OAuth2 apps have I registered on this Gitea instance?
      - Can I see all the OAuth2 applications I own?
      instructions:
      - text: List my OAuth2 applications.
      - text: Show the first {limit} OAuth2 apps I've registered.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/applications/oauth2'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a new OAuth2 application
      effect: write
      questions:
      - How do I register an OAuth2 app so users can sign in to my tool with Gitea?
      - Can I create a public (non-confidential) OAuth2 client?
      instructions:
      - text: Register OAuth2 application {name} with redirect URIs {redirect_uris}.
        slots:
          name: requestBody.name
          redirect_uris: requestBody.redirect_uris
      - text: Create OAuth2 app {name} with confidential client set to {confidential_client}.
        slots:
          name: requestBody.name
          confidential_client: requestBody.confidential_client
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/applications/oauth2/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my OAuth2 applications
      effect: read
      questions:
      - What redirect URIs and client ID does one of my OAuth2 apps have?
      - Can I look up a single OAuth2 application by its ID?
      instructions:
      - text: Show details of my OAuth2 application {id}.
        slots:
          id: path.id
      - text: Get the client ID and redirect URIs for OAuth2 app {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/applications/oauth2/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an OAuth2 application
      effect: destructive
      questions:
      - How do I remove an OAuth2 app I no longer need?
      - Can deleting an OAuth2 application be done by its ID?
      instructions:
      - text: Delete my OAuth2 application {id}.
        slots:
          id: path.id
      - text: Remove OAuth2 app {id} from my account.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/applications/oauth2/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an OAuth2 app and regenerate its secret
      effect: write
      questions:
      - How can I change the redirect URIs on an OAuth2 app I already registered?
      - Does updating an OAuth2 application give me a new client secret?
      instructions:
      - text: Update OAuth2 app {id} to use redirect URIs {redirect_uris}.
        slots:
          id: path.id
          redirect_uris: requestBody.redirect_uris
      - text: Rename OAuth2 application {id} to {name} and regenerate its client secret.
        slots:
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/avatar'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a new profile avatar
      effect: write
      questions:
      - How do I change my profile picture through the API?
      - What image format does the avatar upload expect?
      instructions:
      - text: Set my avatar to the base64 image {image}.
        slots:
          image: requestBody.image
      - text: Replace my profile picture with {image}.
        slots:
          image: requestBody.image
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/avatar'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove my profile avatar
      effect: destructive
      questions:
      - Can I remove my custom avatar and go back to the default?
      - How do I delete the profile picture on my account?
      instructions:
      - text: Delete my profile avatar.
      - text: Reset my avatar back to the default image.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/blocks'].get
  update:
    x-apievangelist-phrasing:
      intent: List users I have blocked
      effect: read
      questions:
      - Who have I blocked on Gitea?
      - Can I get a full list of accounts on my block list?
      instructions:
      - text: List everyone I have blocked.
      - text: Show page {page} of my blocked users.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/blocks/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if I have blocked a user
      effect: read
      questions:
      - Did I already block a particular user?
      - Is there a way to confirm whether someone is on my block list?
      instructions:
      - text: Check whether I have blocked {username}.
        slots:
          username: path.username
      - text: Tell me if {username} is on my block list.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/blocks/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Block a user
      effect: write
      questions:
      - How do I stop a specific user from interacting with me?
      - Can I attach a private note when blocking someone?
      instructions:
      - text: Block user {username}.
        slots:
          username: path.username
      - text: Block {username} with the note {note}.
        slots:
          username: path.username
          note: query.note
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/blocks/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unblock a user
      effect: destructive
      questions:
      - How can I lift a block I placed on another user?
      - Can I unblock someone I blocked by mistake?
      instructions:
      - text: Unblock user {username}.
        slots:
          username: path.username
      - text: Remove {username} from my block list.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/emails'].get
  update:
    x-apievangelist-phrasing:
      intent: List my email addresses
      effect: read
      questions:
      - Which email addresses are attached to my account, and which are verified?
      - What is my primary email on Gitea?
      instructions:
      - text: List all email addresses on my account.
      - text: Show which of my emails are verified and which is primary.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/emails'].post
  update:
    x-apievangelist-phrasing:
      intent: Add email addresses to my account
      effect: write
      questions:
      - How do I add a secondary email address to my Gitea account?
      - Can I add several email addresses in one request?
      instructions:
      - text: Add the email addresses {emails} to my account.
        slots:
          emails: requestBody.emails
      - text: Attach {emails} as additional emails on my profile.
        slots:
          emails: requestBody.emails
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/emails'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove email addresses from my account
      effect: destructive
      questions:
      - How can I take an old email address off my account?
      - Can I delete multiple email addresses at once?
      instructions:
      - text: Remove the email addresses {emails} from my account.
        slots:
          emails: requestBody.emails
      - text: Delete {emails} from my list of emails.
        slots:
          emails: requestBody.emails
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/followers'].get
  update:
    x-apievangelist-phrasing:
      intent: List my followers
      effect: read
      questions:
      - Who follows me on Gitea?
      - How many people are following my account?
      instructions:
      - text: List the users who follow me.
      - text: Show page {page} of my followers.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/following'].get
  update:
    x-apievangelist-phrasing:
      intent: List users I follow
      effect: read
      questions:
      - Which users am I following?
      - Can I see everyone my account follows?
      instructions:
      - text: List the users I am following.
      - text: Show the first {limit} accounts I follow.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/following/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if I follow a user
      effect: read
      questions:
      - Am I already following a particular user?
      - Is there a quick check for whether my account follows someone?
      instructions:
      - text: Check whether I follow {username}.
        slots:
          username: path.username
      - text: Tell me if my account is following {username}.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/following/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Follow a user
      effect: write
      questions:
      - How do I follow another developer's activity?
      - Can I follow a user through the API?
      instructions:
      - text: Follow user {username}.
        slots:
          username: path.username
      - text: Start following {username} from my account.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/following/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unfollow a user
      effect: destructive
      questions:
      - How do I stop following someone?
      - Can I unfollow a user I followed earlier?
      instructions:
      - text: Unfollow user {username}.
        slots:
          username: path.username
      - text: Stop following {username}.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/gpg_key_token'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a token for GPG key verification
      effect: read
      questions:
      - What text do I need to sign to prove I own a GPG key?
      - Where do I get the verification token for signing with my GPG key?
      instructions:
      - text: Give me the token I need to sign to verify my GPG key.
      - text: Fetch my GPG key verification token.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/gpg_key_verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a GPG key
      effect: write
      questions:
      - How do I mark my uploaded GPG key as verified?
      - Can I submit a signed token to verify a GPG key?
      instructions:
      - text: Verify my GPG key using the signed token.
      - text: Submit my signature to complete GPG key verification.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/gpg_keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List my GPG keys
      effect: read
      questions:
      - Which GPG keys have I added to my account?
      - Can I see all the GPG keys used to verify my signed commits?
      instructions:
      - text: List my GPG keys.
      - text: Show page {page} of my GPG keys.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/gpg_keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a GPG key to my account
      effect: write
      questions:
      - How do I upload my GPG public key so my commits show as verified?
      - Can I include an armored signature when adding a GPG key?
      instructions:
      - text: Add GPG public key {armored_public_key} to my account.
        slots:
          armored_public_key: requestBody.armored_public_key
      - text: Upload GPG key {armored_public_key} with signature {armored_signature}.
        slots:
          armored_public_key: requestBody.armored_public_key
          armored_signature: requestBody.armored_signature
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/gpg_keys/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my GPG keys
      effect: read
      questions:
      - What are the details of a specific GPG key on my account?
      - Can I check the emails and expiry tied to one GPG key?
      instructions:
      - text: Show my GPG key {id}.
        slots:
          id: path.id
      - text: Get the details of GPG key {id} on my account.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/gpg_keys/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a GPG key from my account
      effect: destructive
      questions:
      - How do I delete a GPG key I no longer use?
      - Can I revoke a GPG key from my profile by ID?
      instructions:
      - text: Remove GPG key {id} from my account.
        slots:
          id: path.id
      - text: Delete my GPG key {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/hooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List my user-level webhooks
      effect: read
      questions:
      - What webhooks have I configured on my personal account?
      - Can I see every user-level hook I own?
      instructions:
      - text: List the webhooks on my user account.
      - text: Show the first {limit} of my personal webhooks.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/hooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user-level webhook
      effect: write
      questions:
      - How do I set up a webhook that fires for events across my personal account?
      - Can I restrict a new user webhook to certain branches?
      instructions:
      - text: Create a {type} webhook on my account with config {config}.
        slots:
          type: requestBody.type
          config: requestBody.config
      - text: Add a {type} user webhook with config {config} for events {events}.
        slots:
          type: requestBody.type
          config: requestBody.config
          events: requestBody.events
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/hooks/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my user-level webhooks
      effect: read
      questions:
      - What events and URL does one of my personal webhooks use?
      - Can I look up a single user webhook by ID?
      instructions:
      - text: Show my user webhook {id}.
        slots:
          id: path.id
      - text: Get the configuration of personal hook {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/hooks/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user-level webhook
      effect: destructive
      questions:
      - How do I remove a webhook from my personal account?
      - Can I delete a user hook by its ID?
      instructions:
      - text: Delete my user webhook {id}.
        slots:
          id: path.id
      - text: Remove personal hook {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/hooks/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a user-level webhook
      effect: write
      questions:
      - Can I deactivate one of my personal webhooks without deleting it?
      - How do I change which events an existing user webhook listens for?
      instructions:
      - text: Set active to {active} on my user webhook {id}.
        slots:
          active: requestBody.active
          id: path.id
      - text: Change my personal hook {id} to fire on events {events}.
        slots:
          id: path.id
          events: requestBody.events
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List my SSH public keys
      effect: read
      questions:
      - Which SSH keys are registered on my account?
      - Can I find one of my SSH keys by its fingerprint?
      instructions:
      - text: List my SSH public keys.
      - text: Find my public key with fingerprint {fingerprint}.
        slots:
          fingerprint: query.fingerprint
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an SSH public key to my account
      effect: write
      questions:
      - How do I add an SSH key so I can push over SSH?
      - Can I add a read-only SSH key to my account?
      instructions:
      - text: Add SSH key {key} to my account titled {title}.
        slots:
          key: requestBody.key
          title: requestBody.title
      - text: Upload public key {key} named {title} as read-only {read_only}.
        slots:
          key: requestBody.key
          title: requestBody.title
          read_only: requestBody.read_only
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/keys/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one of my SSH public keys
      effect: read
      questions:
      - What are the details of one SSH key on my account?
      - Can I check the fingerprint of a single public key by ID?
      instructions:
      - text: Show my public key {id}.
        slots:
          id: path.id
      - text: Get the fingerprint and title of my SSH key {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/keys/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an SSH public key from my account
      effect: destructive
      questions:
      - How do I remove an SSH key from a laptop I lost?
      - Can I delete one of my public keys by ID?
      instructions:
      - text: Delete my SSH public key {id}.
        slots:
          id: path.id
      - text: Remove public key {id} from my account.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/repos'].get
  update:
    x-apievangelist-phrasing:
      intent: List repositories I own
      effect: read
      questions:
      - Which repositories does my account own?
      - Can I page through all my own repos?
      instructions:
      - text: List the repositories I own.
      - text: Show page {page} of my repositories.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/repos'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a repository under my account
      effect: write
      questions:
      - How do I create a new repository under my own account?
      - Can a new repo start with a README, license and .gitignore already in it?
      instructions:
      - text: Create a repository named {name} under my account.
        slots:
          name: requestBody.name
      - text: Create private repo {name} initialized with license {license} and gitignore {gitignores}.
        slots:
          name: requestBody.name
          license: requestBody.license
          gitignores: requestBody.gitignores
      - text: Create repo {name} with default branch {default_branch} and description {description}.
        slots:
          name: requestBody.name
          default_branch: requestBody.default_branch
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my account settings
      effect: read
      questions:
      - What theme, language and privacy settings does my account have?
      - Is my email currently hidden from my public profile?
      instructions:
      - text: Show my account settings.
      - text: Get my current theme, language and diff view preferences.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/settings'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update my account settings
      effect: write
      questions:
      - How do I change my display name or website through the API?
      - Can I hide my activity and email from other users?
      instructions:
      - text: Set my full name to {full_name} and location to {location}.
        slots:
          full_name: requestBody.full_name
          location: requestBody.location
      - text: Switch my theme to {theme} and language to {language}.
        slots:
          theme: requestBody.theme
          language: requestBody.language
      - text: Set hide email to {hide_email} and hide activity to {hide_activity}.
        slots:
          hide_email: requestBody.hide_email
          hide_activity: requestBody.hide_activity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/starred'].get
  update:
    x-apievangelist-phrasing:
      intent: List repositories I have starred
      effect: read
      questions:
      - Which repositories have I starred?
      - Can I get my starred repos a page at a time?
      instructions:
      - text: List the repositories I've starred.
      - text: Show the first {limit} repos in my stars.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/starred/{owner}/{repo}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if I starred a repository
      effect: read
      questions:
      - Have I already starred a particular repository?
      - Is there a check for whether a repo is in my stars?
      instructions:
      - text: Check whether I've starred {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Tell me if {owner}/{repo} is in my starred list.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/starred/{owner}/{repo}'].put
  update:
    x-apievangelist-phrasing:
      intent: Star a repository
      effect: write
      questions:
      - How do I star a repository through the API?
      - Can I bookmark a repo by starring it?
      instructions:
      - text: Star the repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Add a star to {repo} owned by {owner}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/starred/{owner}/{repo}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unstar a repository
      effect: destructive
      questions:
      - How do I remove my star from a repository?
      - Can I unstar a repo I starred by accident?
      instructions:
      - text: Unstar the repository {owner}/{repo}.
        slots:
          owner: path.owner
          repo: path.repo
      - text: Remove my star from {repo} owned by {owner}.
        slots:
          owner: path.owner
          repo: path.repo
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/stopwatches'].get
  update:
    x-apievangelist-phrasing:
      intent: List my running issue stopwatches
      effect: read
      questions:
      - Which issues do I currently have a time-tracking stopwatch running on?
      - Did I leave a stopwatch going somewhere?
      instructions:
      - text: List all my running stopwatches.
      - text: Show the issues where I have an active stopwatch.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/subscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List repositories I am watching
      effect: read
      questions:
      - Which repositories am I watching for notifications?
      - Can I see every repo I'm subscribed to?
      instructions:
      - text: List the repositories I'm watching.
      - text: Show page {page} of my watched repos.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/teams'].get
  update:
    x-apievangelist-phrasing:
      intent: List teams I belong to
      effect: read
      questions:
      - Which organization teams am I a member of?
      - What teams does my account belong to across all orgs?
      instructions:
      - text: List all the teams I belong to.
      - text: Show the first {limit} of my team memberships.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user/times'].get
  update:
    x-apievangelist-phrasing:
      intent: List my tracked time entries
      effect: read
      questions:
      - How much time have I logged on issues recently?
      - Can I get my tracked time entries within a date range?
      instructions:
      - text: List my tracked time since {since}.
        slots:
          since: query.since
      - text: Show my tracked time entries between {since} and {before}.
        slots:
          since: query.since
          before: query.before
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search for users
      effect: read
      questions:
      - How can I find a Gitea user when I only know part of their name?
      - Can I look up a user by their numeric user ID?
      instructions:
      - text: Search for users matching {q}.
        slots:
          q: query.q
      - text: Find the user with ID {uid}.
        slots:
          uid: query.uid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's public profile
      effect: read
      questions:
      - What does another user's public profile say about them?
      - Can I get someone's profile details from their username?
      instructions:
      - text: Show the profile of user {username}.
        slots:
          username: path.username
      - text: Get account details for {username}.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/activities/feeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's activity feed
      effect: read
      questions:
      - What has a particular user been doing lately?
      - Can I see a user's activity on a specific date?
      instructions:
      - text: Show the activity feed of {username}.
        slots:
          username: path.username
      - text: List what {username} did on {date}.
        slots:
          username: path.username
          date: query.date
      - text: Show only actions performed by {username}, setting only-performed-by to {only_performed_by}.
        slots:
          username: path.username
          only_performed_by: query.only-performed-by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/followers'].get
  update:
    x-apievangelist-phrasing:
      intent: List another user's followers
      effect: read
      questions:
      - Who follows a given user?
      - Can I see the followers of someone else's account?
      instructions:
      - text: List the followers of {username}.
        slots:
          username: path.username
      - text: Show page {page} of {username}'s followers.
        slots:
          username: path.username
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/following'].get
  update:
    x-apievangelist-phrasing:
      intent: List who another user follows
      effect: read
      questions:
      - Which accounts does a given user follow?
      - Can I see who someone else is following?
      instructions:
      - text: List the users that {username} follows.
        slots:
          username: path.username
      - text: Show who {username} is following.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/following/{target}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if one user follows another
      effect: read
      questions:
      - Does one user follow another specific user?
      - Is there a way to test whether two other users are connected by a follow?
      instructions:
      - text: Check whether {username} follows {target}.
        slots:
          username: path.username
          target: path.target
      - text: Tell me if {target} is followed by {username}.
        slots:
          username: path.username
          target: path.target
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/gpg_keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List another user's GPG keys
      effect: read
      questions:
      - Which GPG keys has a given user published?
      - Can I fetch someone's GPG keys to check their signed commits?
      instructions:
      - text: List the GPG keys of {username}.
        slots:
          username: path.username
      - text: Show {username}'s published GPG keys.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/heatmap'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's contribution heatmap
      effect: read
      questions:
      - How active has a user been day by day?
      - Can I get the contribution heatmap for someone's profile?
      instructions:
      - text: Get the contribution heatmap for {username}.
        slots:
          username: path.username
      - text: Show daily contribution counts for {username}.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List another user's SSH public keys
      effect: read
      questions:
      - Which SSH public keys does a given user have?
      - Can I check if a user owns a key with a certain fingerprint?
      instructions:
      - text: List the SSH public keys of {username}.
        slots:
          username: path.username
      - text: Find {username}'s public key with fingerprint {fingerprint}.
        slots:
          username: path.username
          fingerprint: query.fingerprint
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/repos'].get
  update:
    x-apievangelist-phrasing:
      intent: List another user's repositories
      effect: read
      questions:
      - What repositories does a given user own?
      - Can I list someone else's repos page by page?
      instructions:
      - text: List the repositories owned by {username}.
        slots:
          username: path.username
      - text: Show page {page} of {username}'s repos.
        slots:
          username: path.username
          page: query.page
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/starred'].get
  update:
    x-apievangelist-phrasing:
      intent: List repositories another user starred
      effect: read
      questions:
      - Which repositories has a given user starred?
      - Can I see someone else's starred repos?
      instructions:
      - text: List the repos starred by {username}.
        slots:
          username: path.username
      - text: Show the first {limit} repos {username} has starred.
        slots:
          username: path.username
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/subscriptions'].get
  update:
    x-apievangelist-phrasing:
      intent: List repositories another user watches
      effect: read
      questions:
      - Which repositories is a given user watching?
      - Can I see the watched repos of someone else's account?
      instructions:
      - text: List the repositories {username} is watching.
        slots:
          username: path.username
      - text: Show {username}'s watched repos.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/tokens'].get
  update:
    x-apievangelist-phrasing:
      intent: List my personal access tokens
      effect: read
      questions:
      - Which personal access tokens exist on my account?
      - Can I audit all the API tokens I've created?
      instructions:
      - text: List the access tokens for {username}.
        slots:
          username: path.username
      - text: Show all personal access tokens on account {username}.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/tokens'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a personal access token
      effect: write
      questions:
      - How do I generate a new API token for scripts?
      - Can I limit a new access token to specific scopes?
      instructions:
      - text: Create an access token named {name} for {username}.
        slots:
          name: requestBody.name
          username: path.username
      - text: Create token {name} for {username} with scopes {scopes}.
        slots:
          name: requestBody.name
          username: path.username
          scopes: requestBody.scopes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/users/{username}/tokens/{token}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a personal access token
      effect: destructive
      questions:
      - How do I revoke an access token that may have leaked?
      - Can I delete a token by its name or ID?
      instructions:
      - text: Delete access token {token} from {username}.
        slots:
          token: path.token
          username: path.username
      - text: Revoke {username}'s token {token}.
        slots:
          token: path.token
          username: path.username
      method: generated
      generated: '2026-09-26'