# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Bitbucket Issue tracker API
  version: 1.0.0
extends: openapi/bitbucket-issue-tracker-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 33
- target: $.paths['/repositories/{workspace}/{repo_slug}/components'].get
  update:
    x-apievangelist-phrasing:
      intent: List issue tracker components
      effect: read
      questions:
      - What components can I file issues against in a repository's tracker?
      - Which component categories are defined for this repo's issues?
      instructions:
      - text: List the issue components defined in {workspace}/{repo_slug}.
        slots:
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show every component available for tagging issues in repo {repo_slug}, workspace {workspace}.
        slots:
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/components/{component_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an issue tracker component
      effect: read
      questions:
      - What is the name of the issue component with a given id?
      - Can I look up a single tracker component by its id?
      instructions:
      - text: Get issue component {component_id} in {workspace}/{repo_slug}.
        slots:
          component_id: path.component_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show the details of component {component_id} from the issue tracker of repo {repo_slug}, workspace {workspace}.
        slots:
          component_id: path.component_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues'].get
  update:
    x-apievangelist-phrasing:
      intent: List a repository's issues
      effect: read
      questions:
      - What issues are filed in a Bitbucket repository's tracker?
      - Where can I browse all the bugs and tasks reported against a repo?
      instructions:
      - text: List the issues in {workspace}/{repo_slug}.
        slots:
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show all tracker issues for repo {repo_slug} in workspace {workspace}.
        slots:
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues'].post
  update:
    x-apievangelist-phrasing:
      intent: File a new issue
      effect: write
      questions:
      - How do I report a new bug in a repository's issue tracker?
      - Can I set the priority, kind and assignee when I file an issue?
      instructions:
      - text: Create an issue titled {title} in {workspace}/{repo_slug}.
        slots:
          title: requestBody.title
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: File a {kind} with priority {priority} titled {title} in repo {repo_slug}, workspace {workspace}, assigned to {assignee}.
        slots:
          kind: requestBody.kind
          priority: requestBody.priority
          title: requestBody.title
          repo_slug: path.repo_slug
          workspace: path.workspace
          assignee: requestBody.assignee
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/export'].post
  update:
    x-apievangelist-phrasing:
      intent: Start an export of a repo's issues
      effect: write
      questions:
      - How do I back up every issue in a repository to a zip archive?
      - Can the issue export include attachments and email me when it is done?
      instructions:
      - text: Export all issues from {workspace}/{repo_slug} to a zip archive.
        slots:
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Start an issue export for repo {repo_slug} in {workspace} with attachments set to {include_attachments} and email {send_email}.
        slots:
          repo_slug: path.repo_slug
          workspace: path.workspace
          include_attachments: requestBody.include_attachments
          send_email: requestBody.send_email
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/export/{repo_name}-issues-{task_id}.zip'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an issue export and download the zip
      effect: read
      questions:
      - Has my issue export finished, and where do I get the zip file?
      - How do I poll progress on a running issue archive job?
      instructions:
      - text: Check export task {task_id} for repo {repo_name} in {workspace}/{repo_slug} and download the zip when ready.
        slots:
          task_id: path.task_id
          repo_name: path.repo_name
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Poll the issue export job {task_id} of {repo_name} in workspace {workspace}, repo {repo_slug}.
        slots:
          task_id: path.task_id
          repo_name: path.repo_name
          workspace: path.workspace
          repo_slug: path.repo_slug
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/import'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of an issue import
      effect: read
      questions:
      - Is the issue import I started still running or has it completed?
      - What progress has the current issue import job made?
      instructions:
      - text: Check the issue import status for {workspace}/{repo_slug}.
        slots:
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Report how far the running issue import has got in repo {repo_slug}, workspace {workspace}.
        slots:
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/import'].post
  update:
    x-apievangelist-phrasing:
      intent: Import issues from a zip, replacing existing ones
      effect: destructive
      questions:
      - How do I load an issue archive zip into a repository's tracker?
      - Will importing issues wipe out the ones that are already there?
      instructions:
      - text: Import an issues zip archive into {workspace}/{repo_slug}, replacing current issues.
        slots:
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Replace every issue in repo {repo_slug}, workspace {workspace}, with the contents of an exported archive.
        slots:
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an issue
      effect: read
      questions:
      - What is the status, assignee and priority of a specific issue?
      - How do I fetch one issue by its number?
      instructions:
      - text: 'Get issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show me the details of issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an issue
      effect: write
      questions:
      - Can I edit the title or description of an issue after it is filed?
      - Is there a way to modify an issue's fields directly instead of logging a change?
      instructions:
      - text: 'Update issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Edit the fields of issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an issue
      effect: destructive
      questions:
      - How do I permanently remove a spam issue from the tracker?
      - What access do I need to delete an issue?
      instructions:
      - text: 'Delete issue #{issue_id} from {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Permanently remove issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/attachments'].get
  update:
    x-apievangelist-phrasing:
      intent: List files attached to an issue
      effect: read
      questions:
      - What files have been attached to an issue?
      - Can I see attachment names and metadata for an issue without downloading them?
      instructions:
      - text: 'List the attachments on issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show the attached file metadata for issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/attachments'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload an attachment to an issue
      effect: write
      questions:
      - How do I attach a screenshot or log file to an issue?
      - What happens if I upload a file with the same name as an existing attachment?
      instructions:
      - text: 'Upload a file attachment to issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Attach a screenshot to issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/attachments/{path}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download an issue attachment
      effect: read
      questions:
      - How do I download the contents of a file attached to an issue?
      - Where does the link to a specific issue attachment redirect?
      instructions:
      - text: 'Download attachment {path} from issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          path: path.path
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Fetch the file {path} attached to issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          path: path.path
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/attachments/{path}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an issue attachment
      effect: destructive
      questions:
      - How do I remove a file that was attached to an issue by mistake?
      - Can I delete a single attachment while keeping the issue?
      instructions:
      - text: 'Delete attachment {path} from issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          path: path.path
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Remove the attached file {path} on issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          path: path.path
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/changes'].get
  update:
    x-apievangelist-phrasing:
      intent: List the change history of an issue
      effect: read
      questions:
      - Who changed an issue's state or assignee, and when?
      - Can I see an issue's change log oldest first, filtered to state changes?
      instructions:
      - text: 'List the changes made to issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show the history of issue {issue_id} in repo {repo_slug}, workspace {workspace}, filtered by {q}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
          q: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/changes'].post
  update:
    x-apievangelist-phrasing:
      intent: Change an issue's state or assignee
      effect: write
      questions:
      - How do I resolve or reassign an issue and record it in its history?
      - Can I change an issue's state and leave a message explaining why in one step?
      instructions:
      - text: 'Log a change on issue #{issue_id} in {workspace}/{repo_slug} applying {changes}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
          changes: requestBody.changes
      - text: Transition issue {issue_id} in repo {repo_slug}, workspace {workspace}, with changes {changes} and note {message}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
          changes: requestBody.changes
          message: requestBody.message
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/changes/{change_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one change on an issue
      effect: read
      questions:
      - What exactly did a particular recorded change do to an issue?
      - How can I fetch a single entry from an issue's change history?
      instructions:
      - text: 'Get change {change_id} on issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          change_id: path.change_id
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show history entry {change_id} for issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          change_id: path.change_id
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/comments'].get
  update:
    x-apievangelist-phrasing:
      intent: List comments on an issue
      effect: read
      questions:
      - What discussion has happened in the comments on an issue?
      - Can I filter an issue's comments, for example by author?
      instructions:
      - text: 'List comments on issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show the comments on issue {issue_id} in repo {repo_slug}, workspace {workspace}, matching {q}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
          q: query.q
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/comments'].post
  update:
    x-apievangelist-phrasing:
      intent: Comment on an issue
      effect: write
      questions:
      - How do I reply to a bug report with a comment?
      - Can an agent post a status update as a comment on an issue?
      instructions:
      - text: 'Add a comment to issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Post a status update comment on issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/comments/{comment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one comment on an issue
      effect: read
      questions:
      - How do I fetch a single issue comment by its id?
      - What did a specific comment on an issue say?
      instructions:
      - text: 'Get comment {comment_id} on issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          comment_id: path.comment_id
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show issue comment {comment_id} from issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          comment_id: path.comment_id
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/comments/{comment_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a comment on an issue
      effect: write
      questions:
      - Can I fix a typo in a comment I left on an issue?
      - Which part of an issue comment is editable after posting?
      instructions:
      - text: 'Edit comment {comment_id} on issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          comment_id: path.comment_id
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Rewrite the text of issue comment {comment_id} on issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          comment_id: path.comment_id
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/comments/{comment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a comment on an issue
      effect: destructive
      questions:
      - How do I remove an inappropriate comment from an issue?
      - Can I delete one comment without touching the rest of the issue thread?
      instructions:
      - text: 'Delete comment {comment_id} from issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          comment_id: path.comment_id
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Remove issue comment {comment_id} on issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          comment_id: path.comment_id
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/vote'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether I voted for an issue
      effect: read
      questions:
      - Have I already upvoted this issue?
      - Does a 404 on the vote check mean I have not voted?
      instructions:
      - text: 'Check whether I have voted for issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Tell me if my vote is recorded on issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/vote'].put
  update:
    x-apievangelist-phrasing:
      intent: Vote for an issue
      effect: write
      questions:
      - How do I upvote an issue I also care about?
      - Can I add my vote to a feature request in the tracker?
      instructions:
      - text: 'Vote for issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Cast my upvote on issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/vote'].delete
  update:
    x-apievangelist-phrasing:
      intent: Retract my vote on an issue
      effect: destructive
      questions:
      - How do I take back an upvote I gave an issue?
      - Can I withdraw my vote from a feature request?
      instructions:
      - text: 'Retract my vote on issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Withdraw my upvote from issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/watch'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether I'm watching an issue
      effect: read
      questions:
      - Am I subscribed to notifications for a particular issue?
      - Is there a quick way to see if I am already following an issue?
      instructions:
      - text: 'Check whether I am watching issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Tell me if I follow issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/watch'].put
  update:
    x-apievangelist-phrasing:
      intent: Watch an issue
      effect: write
      questions:
      - How do I get notified whenever an issue is updated?
      - Can I start following an issue someone else filed?
      instructions:
      - text: 'Start watching issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Subscribe me to updates on issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/issues/{issue_id}/watch'].delete
  update:
    x-apievangelist-phrasing:
      intent: Stop watching an issue
      effect: destructive
      questions:
      - How do I stop getting notifications about an issue?
      - Can I unfollow an issue I no longer care about?
      instructions:
      - text: 'Stop watching issue #{issue_id} in {workspace}/{repo_slug}.'
        slots:
          issue_id: path.issue_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Unsubscribe me from updates on issue {issue_id} in repo {repo_slug}, workspace {workspace}.
        slots:
          issue_id: path.issue_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/milestones'].get
  update:
    x-apievangelist-phrasing:
      intent: List issue tracker milestones
      effect: read
      questions:
      - What milestones are defined for planning a repo's issues?
      - Which release milestones can I assign an issue to?
      instructions:
      - text: List the milestones in the issue tracker of {workspace}/{repo_slug}.
        slots:
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show every milestone defined for repo {repo_slug} in workspace {workspace}.
        slots:
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/milestones/{milestone_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an issue tracker milestone
      effect: read
      questions:
      - What is the name of the milestone with a given id?
      - How do I fetch one tracker milestone by id?
      instructions:
      - text: Get milestone {milestone_id} in {workspace}/{repo_slug}.
        slots:
          milestone_id: path.milestone_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show the details of milestone {milestone_id} for repo {repo_slug}, workspace {workspace}.
        slots:
          milestone_id: path.milestone_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List versions defined for issues
      effect: read
      questions:
      - Which product versions can an issue be reported against in this tracker?
      - What version labels exist for a repository's issues?
      instructions:
      - text: List the issue versions defined in {workspace}/{repo_slug}.
        slots:
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show every version label available for issues in repo {repo_slug}, workspace {workspace}.
        slots:
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/repositories/{workspace}/{repo_slug}/versions/{version_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a version defined for issues
      effect: read
      questions:
      - What version name does a given version id correspond to?
      - How do I fetch a single issue tracker version by id?
      instructions:
      - text: Get issue version {version_id} in {workspace}/{repo_slug}.
        slots:
          version_id: path.version_id
          workspace: path.workspace
          repo_slug: path.repo_slug
      - text: Show version {version_id} from the tracker of repo {repo_slug}, workspace {workspace}.
        slots:
          version_id: path.version_id
          repo_slug: path.repo_slug
          workspace: path.workspace
      method: generated
      generated: '2026-10-01'