# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Jira Cloud platform REST Project templates API
  version: 1.0.0
extends: openapi/jira-project-templates-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: 5
- target: $.paths['/rest/api/3/project-template'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a project from a custom template
      effect: write
      questions:
      - How do I create a project whose configuration comes from a custom template?
      - Is project creation from a custom template asynchronous, and how do I track it?
      instructions:
      - text: Create a project with details {details} using template capabilities {template}.
        slots:
          details: requestBody.details
          template: requestBody.template
      - text: Spin up a new project {details} from the custom template {template} and tell me the task status.
        slots:
          details: requestBody.details
          template: requestBody.template
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/project-template/edit-template'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a custom project template
      effect: write
      questions:
      - Can I rename or re-describe a saved custom project template?
      - Are custom project templates only available on the Enterprise edition?
      instructions:
      - text: Rename custom template {templateKey} to {templateName}.
        slots:
          templateKey: requestBody.templateKey
          templateName: requestBody.templateName
      - text: Update the description of project template {templateKey} to {templateDescription}.
        slots:
          templateKey: requestBody.templateKey
          templateDescription: requestBody.templateDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/project-template/live-template'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom project template
      effect: read
      questions:
      - What does a live custom project template contain?
      - Can I look up the custom template a project was created from by project ID?
      instructions:
      - text: Get custom project template {templateKey}.
        slots:
          templateKey: query.templateKey
      - text: Show the live template behind project {projectId}.
        slots:
          projectId: query.projectId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/project-template/remove-template'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom project template
      effect: destructive
      questions:
      - How do I delete a custom project template I no longer want?
      - Can a saved project template be removed permanently?
      instructions:
      - text: Delete custom project template {templateKey}.
        slots:
          templateKey: query.templateKey
      - text: Remove the saved project template with key {templateKey}.
        slots:
          templateKey: query.templateKey
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/project-template/save-template'].post
  update:
    x-apievangelist-phrasing:
      intent: Save a project as a custom template
      effect: write
      questions:
      - Can I turn an existing project's setup into a reusable template?
      - What do I need to save a new custom project template?
      instructions:
      - text: Save a custom template named {templateName} from project {templateFromProjectRequest}.
        slots:
          templateName: requestBody.templateName
          templateFromProjectRequest: requestBody.templateFromProjectRequest
      - text: Save template {templateName} described as {templateDescription}.
        slots:
          templateName: requestBody.templateName
          templateDescription: requestBody.templateDescription
      method: generated
      generated: '2026-09-26'