# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Harness Account Template API version: 1.0.0 extends: openapi/harness-account-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/templates'].get update: x-apievangelist-phrasing: intent: List account-level templates effect: read questions: - What templates are defined at the account level? - Can I filter account templates by entity type or search by name? instructions: - text: List account templates matching {search_term}. slots: search_term: query.search_term - text: Show account-scope templates of entity type {entity_types}. slots: entity_types: query.entity_types method: generated generated: '2026-09-26' - target: $.paths['/v1/templates'].post update: x-apievangelist-phrasing: intent: Create an account-level template effect: write questions: - How do I publish a reusable pipeline or step template for the whole account? - Can I mark a new account template version as stable when I create it? instructions: - text: Create an account template from YAML {template_yaml}. slots: template_yaml: requestBody.template_yaml - text: Create account template {name} with version label {label} and mark it stable {is_stable}. slots: name: requestBody.name label: requestBody.label is_stable: requestBody.is_stable method: generated generated: '2026-09-26' - target: $.paths['/v1/templates/git-metadata/{template}'].put update: x-apievangelist-phrasing: intent: Update Git details for a template's versions effect: write questions: - Can I update the Git metadata for all versions of a template at once? - How do I fix a template's Git details after its repo moved? instructions: - text: Update Git details across versions of template {template}. slots: template: path.template - text: Refresh the Git metadata stored for account template {template}. slots: template: path.template method: generated generated: '2026-09-26' - target: $.paths['/v1/templates/{template}'].get update: x-apievangelist-phrasing: intent: Get the stable version of a template effect: read questions: - Which version of an account template is currently marked stable? - Can I get the stable template's YAML from a specific Git branch? instructions: - text: Get the stable version of account template {template}. slots: template: path.template - text: Fetch stable template {template} with YAML from branch {branch_name}. slots: template: path.template branch_name: query.branch_name method: generated generated: '2026-09-26' - target: $.paths['/v1/templates/{template}/versions/{version}'].get update: x-apievangelist-phrasing: intent: Get a specific template version effect: read questions: - How do I retrieve a particular version label of an account template? - Can I include the YAML when fetching one template version? instructions: - text: Get version {version} of account template {template}. slots: version: path.version template: path.template - text: Show template {template} at version {version} including YAML. slots: template: path.template version: path.version method: generated generated: '2026-09-26' - target: $.paths['/v1/templates/{template}/versions/{version}'].put update: x-apievangelist-phrasing: intent: Update a template version effect: write questions: - Can I edit the YAML of one existing template version? - How do I add a change comment when updating an account template? instructions: - text: Update version {version} of template {template} with YAML {template_yaml}. slots: version: path.version template: path.template template_yaml: requestBody.template_yaml - text: Change the description of template {template} version {version} to {description}. slots: template: path.template version: path.version description: requestBody.description method: generated generated: '2026-09-26' - target: $.paths['/v1/templates/{template}/versions/{version}'].delete update: x-apievangelist-phrasing: intent: Delete a template version effect: destructive questions: - How do I delete one version of an account template? - Can I force-delete a template version that pipelines still reference? instructions: - text: Delete version {version} of account template {template}. slots: version: path.version template: path.template - text: Force-delete template {template} version {version} with comment {comments}. slots: template: path.template version: path.version comments: query.comments method: generated generated: '2026-09-26' - target: $.paths['/v1/templates/{template}/versions/{version}/stable'].put update: x-apievangelist-phrasing: intent: Mark a template version as stable effect: write questions: - How do I promote a template version to be the stable one? - Which version do pipelines pick up after I change the stable template? instructions: - text: Make version {version} the stable version of template {template}. slots: version: path.version template: path.template - text: Promote template {template} version {version} to stable with note {comments}. slots: template: path.template version: path.version comments: requestBody.comments method: generated generated: '2026-09-26' - target: $.paths['/v1/templates/{template}/import'].post update: x-apievangelist-phrasing: intent: Import an account template from Git effect: write questions: - Can I import a template that already lives in a Git repo into my account? - What Git details do I need to import a template? instructions: - text: Import template {template} into the account from Git using {git_import_details}. slots: template: path.template git_import_details: requestBody.git_import_details - text: Pull account template {template} in from its repository. slots: template: path.template method: generated generated: '2026-09-26' - target: $.paths['/v1/templates/{template}/versions/{version}/inputs-schema'].get update: x-apievangelist-phrasing: intent: Get the inputs schema of a template effect: read questions: - What runtime inputs does an account template version expect? - Is there a schema describing an account template's inputs? instructions: - text: Get the inputs schema for template {template} version {version}. slots: template: path.template version: path.version - text: Show which inputs account template {template} at {version} requires. slots: template: path.template version: path.version method: generated generated: '2026-09-26'