Harness · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Harness Integration Step Config API

4 actions 4 updates phrasing extends openapi/harness-integration-step-config-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Harness's API. It is a proposal applied on top of the contract, not a document Harness publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 4

$.info
$.paths['/gateway/ssca-manager/v1/ssca-config/integration-step'].post
$.paths['/gateway/ssca-manager/v1/orgs/{org}/projects/{project}/ssca-config/integration-step'].post
$.paths['/gateway/ssca-manager/v1/orgs/{org}/ssca-config/integration-step'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Integration Step Config API
  version: 1.0.0
extends: openapi/harness-integration-step-config-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: 3
- target: $.paths['/gateway/ssca-manager/v1/ssca-config/integration-step'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the integration step config for the account
      effect: write
      questions:
      - How do I set a supply chain integration step config for my whole account?
      - Can I define an account-wide default for the integration step?
      instructions:
      - text: Set the account-level integration step config {name} to {config}.
        slots:
          name: requestBody.name
          config: requestBody.config
      - text: Apply integration step config {config} across account {account}.
        slots:
          config: requestBody.config
          account: header.Harness-Account
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/ssca-manager/v1/orgs/{org}/projects/{project}/ssca-config/integration-step'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the integration step config for a project
      effect: write
      questions:
      - Can one project have its own integration step config?
      - How do I override the integration step settings for a single project?
      instructions:
      - text: Set integration step config {name} to {config} for org {org} project {project}.
        slots:
          name: requestBody.name
          config: requestBody.config
          org: path.org
          project: path.project
      - text: Override the integration step config in project {project} of org {org}.
        slots:
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/ssca-manager/v1/orgs/{org}/ssca-config/integration-step'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the integration step config for an org
      effect: write
      questions:
      - Can I set integration step config at the organization level?
      - How do I apply an integration step config to every project in an org?
      instructions:
      - text: At the organization level only, configure integration step {name} as {config} in org {org}.
        slots:
          name: requestBody.name
          config: requestBody.config
          org: path.org
      - text: Apply org-wide integration step config for org {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-26'