# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Docker Artifacts API
  version: 1.0.0
extends: openapi/harness-docker-artifacts-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['/har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/docker/details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a Docker image version
      effect: read
      questions:
      - What details are stored for a specific Docker image version in my artifact registry?
      - Can I look up a Docker image by its digest?
      instructions:
      - text: Get details of Docker image {artifact} version {version} digest {digest} in registry {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          digest: query.digest
          registry: path.registry_ref
      - text: Describe {artifact}:{version} with digest {digest} from registry {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          digest: query.digest
          registry: path.registry_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/docker/integrationdetails'].get
  update:
    x-apievangelist-phrasing:
      intent: Get integration details for a Docker image
      effect: read
      questions:
      - Which pipelines and integrations have touched a given Docker image version?
      - Can I see integration info for an image digest?
      instructions:
      - text: Show integration details for Docker image {artifact} version {version} digest {digest} in {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          digest: query.digest
          registry: path.registry_ref
      - text: Get integrations linked to {artifact}:{version} ({digest}) in registry {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          digest: query.digest
          registry: path.registry_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/docker/layers'].get
  update:
    x-apievangelist-phrasing:
      intent: List the layers of a Docker image
      effect: read
      questions:
      - What layers make up a Docker image version and how big is each?
      - Can I inspect an image's layer history by digest?
      instructions:
      - text: List the layers of Docker image {artifact} version {version} digest {digest} in {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          digest: query.digest
          registry: path.registry_ref
      - text: Show layer breakdown for {artifact}:{version} at digest {digest} in registry {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          digest: query.digest
          registry: path.registry_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/docker/manifest'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the manifest for one Docker image digest
      effect: read
      questions:
      - Can I read the raw manifest of a Docker image for a specific digest?
      - Where do I get the single-platform manifest for an image?
      instructions:
      - text: Get the manifest of Docker image {artifact} version {version} digest {digest} in {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          digest: query.digest
          registry: path.registry_ref
      - text: Show the raw manifest JSON for {artifact}:{version} at digest {digest}, registry {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          digest: query.digest
          registry: path.registry_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/registry/{registry_ref}/artifact/{artifact}/version/{version}/docker/manifests'].get
  update:
    x-apievangelist-phrasing:
      intent: List all platform manifests for a Docker image
      effect: read
      questions:
      - Which platforms and architectures does a multi-arch Docker image version include?
      - Can I list every manifest under a Docker tag?
      instructions:
      - text: List all manifests for Docker image {artifact} version {version} in {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          registry: path.registry_ref
      - text: Show the per-architecture manifests of {artifact}:{version} in registry {registry}.
        slots:
          artifact: path.artifact
          version: path.version
          registry: path.registry_ref
      method: generated
      generated: '2026-09-26'