# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Recommendation Jira API
  version: 1.0.0
extends: openapi/harness-recommendation-jira-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: 10
- target: $.paths['/ccm/api/recommendation/jira/create'].post
  update:
    x-apievangelist-phrasing:
      intent: Open a Jira ticket for a cost recommendation
      effect: write
      questions:
      - How do I create a Jira issue from a cloud cost recommendation?
      - Can I pick the Jira project and issue type when ticketing a recommendation?
      instructions:
      - text: Create a Jira ticket for recommendation {recommendation} on resource type {resource_type}.
        slots:
          recommendation: requestBody.recommendationId
          resource_type: requestBody.resourceType
      - text: File recommendation {recommendation} ({resource_type}) as a {issue_type} in Jira project {project_key}.
        slots:
          recommendation: requestBody.recommendationId
          resource_type: requestBody.resourceType
          issue_type: requestBody.issueType
          project_key: requestBody.projectKey
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/field-mapping'].get
  update:
    x-apievangelist-phrasing:
      intent: List Jira field mappings for recommendations
      effect: read
      questions:
      - Which Jira fields are mapped to savings and variance values on my account?
      - Can I see how recommendation data maps onto Jira fields?
      instructions:
      - text: Show all Jira field mappings for cost recommendations.
      - text: List how recommendation values map to Jira fields on my account.
      - text: List Jira field mappings configured in account {account}.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/field-mapping'].post
  update:
    x-apievangelist-phrasing:
      intent: Replace Jira field mappings for a field type
      effect: write
      questions:
      - How do I set which Jira field receives the savings amount?
      - Can I replace all the variance field mappings at once?
      instructions:
      - text: Replace the Jira field mappings for field type {field_type}.
        slots:
          field_type: query.fieldType
      - text: Overwrite my {field_type} Jira mappings with the new set.
        slots:
          field_type: query.fieldType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/field-mapping'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Jira field mapping for a project
      effect: destructive
      questions:
      - How do I remove the Jira field mapping for one Jira project?
      - Can I delete the mapping only for a single issue type?
      instructions:
      - text: Delete the Jira field mapping for project {project_key}.
        slots:
          project_key: query.projectKey
      - text: Remove the mapping for issue type {issue_type} in Jira project {project_key}.
        slots:
          issue_type: query.issueType
          project_key: query.projectKey
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Unlink Jira tickets from recommendations
      effect: destructive
      questions:
      - How do I clear the Jira ticket details attached to recommendations?
      - Can I detach Jira issues from cost recommendations?
      instructions:
      - text: Remove the Jira details from these recommendations.
      - text: Detach linked Jira tickets from the selected cost recommendations.
      - text: Unlink Jira tickets from the chosen recommendations in account {account}.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/statuses'].get
  update:
    x-apievangelist-phrasing:
      intent: List Jira statuses
      effect: read
      questions:
      - What Jira statuses can a recommendation ticket be in?
      - Which workflow statuses does Harness read from Jira for recommendations?
      instructions:
      - text: List all Jira statuses available for recommendation tickets.
      - text: Show the Jira workflow statuses.
      - text: Fetch Jira statuses for account {account}.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/common-fields'].post
  update:
    x-apievangelist-phrasing:
      intent: Find Jira fields shared across projects
      effect: read
      questions:
      - Which Jira fields exist in all of the projects and issue types I selected?
      - Can I find fields common to several Jira projects for mapping?
      instructions:
      - text: Find fields shared by Jira projects {projects} and issue types {issue_types} via connector {connector}.
        slots:
          projects: requestBody.projectKeys
          issue_types: requestBody.issueTypes
          connector: requestBody.connectorRef
      - text: List {field_type} fields common to projects {projects}, issue types {issue_types}, connector {connector}.
        slots:
          field_type: requestBody.fieldType
          projects: requestBody.projectKeys
          issue_types: requestBody.issueTypes
          connector: requestBody.connectorRef
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/common-issue-types'].post
  update:
    x-apievangelist-phrasing:
      intent: Find Jira issue types shared across projects
      effect: read
      questions:
      - Which issue types are available in every one of my selected Jira projects?
      - Can I get the intersection of issue types for several Jira projects?
      instructions:
      - text: Find issue types common to Jira projects {projects} using connector {connector}.
        slots:
          projects: requestBody.projectKeys
          connector: requestBody.connectorRef
      - text: Show which issue types projects {projects} all share.
        slots:
          projects: requestBody.projectKeys
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/mapped-projects'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Jira projects mapped to a recommendation
      effect: read
      questions:
      - Which Jira projects are mapped to a given recommendation?
      - Where would a ticket for this recommendation be filed in Jira?
      instructions:
      - text: Show the Jira projects mapped to recommendation {recommendation}.
        slots:
          recommendation: query.recommendationId
      - text: List mapped Jira projects for recommendation {recommendation}.
        slots:
          recommendation: query.recommendationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/jira/resolution-code'].get
  update:
    x-apievangelist-phrasing:
      intent: List Jira resolution codes
      effect: read
      questions:
      - What Jira resolution codes can close a recommendation ticket?
      - Which resolutions does Jira offer for finished issues?
      instructions:
      - text: List all Jira resolution codes.
      - text: Show the resolutions available for closing recommendation tickets.
      - text: Fetch Jira resolution codes for account {account}.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'