# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Jira Software Cloud Development Information API
  version: 1.0.0
extends: openapi/jira-development-information-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: 6
- target: $.paths['/rest/devinfo/0.10/bulk'].post
  update:
    x-apievangelist-phrasing:
      intent: Send commits, branches and pull requests to Jira
      effect: write
      questions:
      - How do I push repository commits, branches and pull requests into Jira so they show on issues?
      - Can I stop smart commits from transitioning issues when I send dev data?
      - How many repositories can I include in one development information submission?
      instructions:
      - text: Store development information for repositories {repositories}.
        slots:
          repositories: requestBody.repositories
      - text: 'Send repositories {repositories} to Jira without firing issue transitions: preventTransitions {preventTransitions}.'
        slots:
          repositories: requestBody.repositories
          preventTransitions: requestBody.preventTransitions
      - text: Submit dev info for {repositories} tagged with properties {properties}.
        slots:
          repositories: requestBody.repositories
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/devinfo/0.10/repository/{repositoryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's stored development data
      effect: read
      questions:
      - What development data does Jira currently hold for one of my repositories?
      - How many recent commits and branches come back with a repository lookup?
      instructions:
      - text: Get the stored repository {repositoryId} and its dev entities.
        slots:
          repositoryId: path.repositoryId
      - text: Show what Jira has stored for repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/devinfo/0.10/repository/{repositoryId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository's development data
      effect: destructive
      questions:
      - How do I remove a repository and all of its dev data from Jira?
      - Is deleting a repository's dev information immediate or asynchronous?
      instructions:
      - text: Delete repository {repositoryId} and all its development information.
        slots:
          repositoryId: path.repositoryId
      - text: Remove repository {repositoryId} data older than sequence {_updateSequenceId}.
        slots:
          repositoryId: path.repositoryId
          _updateSequenceId: query._updateSequenceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/devinfo/0.10/bulkByProperties'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete dev data matching tagged properties
      effect: destructive
      questions:
      - Can I wipe all repositories tagged with a certain account or project property?
      - When deleting development data by properties, are the properties combined as AND?
      instructions:
      - text: Delete all development information whose repositories carry every one of the given properties.
      - text: Bulk remove dev data by properties, only entries with sequence below {_updateSequenceId}.
        slots:
          _updateSequenceId: query._updateSequenceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/devinfo/0.10/existsByProperties'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether dev data exists for properties
      effect: read
      questions:
      - Is there any repository data in Jira tagged with a given set of properties?
      - Can I confirm a property-based deletion of dev data has finished?
      instructions:
      - text: Check if any development data exists for the properties I supply.
      - text: Check whether dev data tagged with these properties exists at or below sequence {_updateSequenceId}.
        slots:
          _updateSequenceId: query._updateSequenceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/devinfo/0.10/repository/{repositoryId}/{entityType}/{entityId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one commit, branch or pull request
      effect: destructive
      questions:
      - How do I remove a single pull request or branch from Jira's dev panel?
      - Can I delete one development entity without deleting the whole repository?
      instructions:
      - text: Delete {entityType} {entityId} from repository {repositoryId}.
        slots:
          entityType: path.entityType
          entityId: path.entityId
          repositoryId: path.repositoryId
      - text: Remove only the {entityType} with ID {entityId} in repository {repositoryId} from Jira.
        slots:
          entityType: path.entityType
          entityId: path.entityId
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-09-26'