# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Harness Project Template API version: 1.0.0 extends: openapi/harness-project-template-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['/v1/orgs/{org}/projects/{project}/templates/git-metadata/{template}'].put update: x-apievangelist-phrasing: intent: Update Git details of a project template effect: write questions: - Can I update the Git details stored for every version of a project template? - What changes the Git metadata of a template in my project? instructions: - text: Update Git details for template {template} in project {project} of org {org}. slots: template: path.template org: path.org project: path.project - text: Refresh Git metadata on project template {template}. slots: template: path.template method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates'].get update: x-apievangelist-phrasing: intent: List templates in a project effect: read questions: - Which templates exist in my project? - Can I filter project templates by type or search term? instructions: - text: List templates in project {project} of org {org}. slots: org: path.org project: path.project - text: Search templates in project {project} for {term}. slots: project: path.project term: query.search_term method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates'].post update: x-apievangelist-phrasing: intent: Create a project template effect: write questions: - Can I create a new pipeline template scoped to one project? - What YAML do I need to add a template at project level? instructions: - text: Create template {name} in project {project} of org {org} from YAML {yaml}. slots: name: requestBody.name yaml: requestBody.template_yaml org: path.org project: path.project - text: Add a stable template with YAML {yaml} to project {project}. slots: yaml: requestBody.template_yaml project: path.project method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}'].get update: x-apievangelist-phrasing: intent: Get the stable version of a project template effect: read questions: - Which version of a project template is currently marked stable? - Can I read the stable template's YAML from a specific Git branch? instructions: - text: Get the stable version of template {template} in project {project}, org {org}. slots: template: path.template org: path.org project: path.project - text: Show stable template {template} YAML from branch {branch}. slots: template: path.template branch: query.branch_name method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}'].get update: x-apievangelist-phrasing: intent: Get a specific project template version effect: read questions: - Can I fetch one particular version of a project template? - Is the YAML included when I retrieve a template by version label? instructions: - text: Get version {version} of template {template} in project {project}. slots: version: path.version template: path.template project: path.project - text: Retrieve template {template} version {version} with YAML in org {org}. slots: template: path.template version: path.version org: path.org method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}'].put update: x-apievangelist-phrasing: intent: Update a project template version effect: write questions: - Can I edit the YAML of an existing template version in a project? - Is a commit comment recorded when I update a template version? instructions: - text: Update template {template} version {version} with YAML {yaml}. slots: template: path.template version: path.version yaml: requestBody.template_yaml - text: Edit version {version} of template {template} in project {project}, org {org}. slots: version: path.version template: path.template org: path.org project: path.project method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}'].delete update: x-apievangelist-phrasing: intent: Delete a project template version effect: destructive questions: - Can I delete one version of a template in my project? - Is it possible to force-delete a template version that is still referenced? instructions: - text: Delete version {version} of template {template} in project {project}, org {org}. slots: version: path.version template: path.template org: path.org project: path.project - text: Force delete template {template} version {version} set to {force}. slots: template: path.template version: path.version force: query.forceDelete method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}/stable'].put update: x-apievangelist-phrasing: intent: Mark a project template version stable effect: write questions: - How do I promote a template version to stable in my project? - Can I change which version of a project template is the stable one? instructions: - text: Make version {version} the stable version of template {template} in project {project}, org {org}. slots: version: path.version template: path.template org: path.org project: path.project - text: Set template {template} stable version to {version}. slots: template: path.template version: path.version method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/import'].post update: x-apievangelist-phrasing: intent: Import a template from Git into a project effect: write questions: - Can I import a template that already lives in a Git repo into my project? - What details are needed to import a project template from Git? instructions: - text: Import template {template} into project {project} of org {org}. slots: template: path.template org: path.org project: path.project - text: Import template {template} from Git using {details}. slots: template: path.template details: requestBody.git_import_details method: generated generated: '2026-09-26' - target: $.paths['/v1/orgs/{org}/projects/{project}/templates/{template}/versions/{version}/inputs-schema'].get update: x-apievangelist-phrasing: intent: Get a project template's inputs schema effect: read questions: - What runtime inputs does a project template version expect? - Can I get the input schema for a template before using it? instructions: - text: Get the inputs schema for template {template} version {version} in project {project}, org {org}. slots: template: path.template version: path.version org: path.org project: path.project - text: Show required inputs for template {template} version {version}. slots: template: path.template version: path.version method: generated generated: '2026-09-26'