# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Spaces API
  version: 1.0.0
extends: openapi/harness-spaces-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: 14
- target: $.paths['/har/api/v1/spaces/{space_ref}/artifact/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get artifact stats for a space
      effect: read
      questions:
      - How many artifacts and downloads does a registry space have?
      - Can I see artifact statistics for a date range in a space?
      instructions:
      - text: Show artifact stats for space {space_ref}.
        slots:
          space_ref: path.space_ref
      - text: Get artifact stats in space {space_ref} from {from} to {to}.
        slots:
          space_ref: path.space_ref
          from: query.from
          to: query.to
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifacts across a space's registries
      effect: read
      questions:
      - What artifacts are stored in the registries of this space?
      - Can I list only artifacts that have been deployed?
      - Which artifacts in a space match a package type?
      instructions:
      - text: List all artifacts in space {space_ref}.
        slots:
          space_ref: path.space_ref
      - text: Search artifacts in space {space_ref} for {search_term} in registry {reg_identifier}.
        slots:
          space_ref: path.space_ref
          search_term: query.search_term
          reg_identifier: query.reg_identifier
      - text: List {package_type} artifacts in space {space_ref}.
        slots:
          package_type: query.package_type
          space_ref: path.space_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get storage usage for a space
      effect: read
      questions:
      - How much registry storage is a space using?
      - Where can I see the storage details for a space?
      instructions:
      - text: Show storage details for space {space_ref}.
        slots:
          space_ref: path.space_ref
      - text: How much storage is space {space_ref} consuming, give me the numbers.
        slots:
          space_ref: path.space_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: List labels defined in a space
      effect: read
      questions:
      - What labels are defined in this space?
      - Can I include labels inherited from parent spaces?
      instructions:
      - text: List labels in space {space_ref}.
        slots:
          space_ref: path.space_ref
      - text: 'List labels in space {space_ref} whose key contains {query}, including inherited ones: {inherited}.'
        slots:
          space_ref: path.space_ref
          query: query.query
          inherited: query.inherited
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels'].put
  update:
    x-apievangelist-phrasing:
      intent: Save a label and its values in a space
      effect: write
      questions:
      - Can I create or overwrite a label together with its values in one call?
      - How do I save a full label definition including values for a space?
      instructions:
      - text: Save label {label} with values {values} in space {space_ref}.
        slots:
          label: requestBody.label
          values: requestBody.values
          space_ref: path.space_ref
      - text: Upsert a label and its values in space {space_ref}.
        slots:
          space_ref: path.space_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Define a new label in a space
      effect: write
      questions:
      - How do I define a new label key for a space?
      - Can a new label have a color and description?
      instructions:
      - text: Define label {key} in space {space_ref}.
        slots:
          key: requestBody.key
          space_ref: path.space_ref
      - text: Create label {key} colored {color} in space {space_ref} with description {description}.
        slots:
          key: requestBody.key
          color: requestBody.color
          space_ref: path.space_ref
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels/{key}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one label in a space
      effect: read
      questions:
      - What does a particular label in my space look like?
      - Can I fetch a label along with its allowed values?
      instructions:
      - text: Get label {key} in space {space_ref}.
        slots:
          key: path.key
          space_ref: path.space_ref
      - text: 'Show label {key} in space {space_ref} including values: {include_values}.'
        slots:
          key: path.key
          space_ref: path.space_ref
          include_values: query.include_values
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels/{key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a label from a space
      effect: destructive
      questions:
      - How do I delete a label key from a space?
      - Is removing a space label permanent?
      instructions:
      - text: Delete label {key} from space {space_ref}.
        slots:
          key: path.key
          space_ref: path.space_ref
      - text: Remove the {key} label in space {space_ref}.
        slots:
          key: path.key
          space_ref: path.space_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels/{key}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a label in a space
      effect: write
      questions:
      - Can I rename a label or change its color in a space?
      - How do I edit an existing space label's description?
      instructions:
      - text: Change label {key} in space {space_ref} to color {color}.
        slots:
          key: path.key
          space_ref: path.space_ref
          color: requestBody.color
      - text: Update the description of label {key} in space {space_ref} to {description}.
        slots:
          key: path.key
          space_ref: path.space_ref
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels/{key}/values'].get
  update:
    x-apievangelist-phrasing:
      intent: List the values of a space label
      effect: read
      questions:
      - Which values can a given label take in this space?
      - What values are defined under a label key?
      instructions:
      - text: List the values of label {key} in space {space_ref}.
        slots:
          key: path.key
          space_ref: path.space_ref
      - text: Show allowed values for label {key} in {space_ref}.
        slots:
          key: path.key
          space_ref: path.space_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels/{key}/values'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a value to a space label
      effect: write
      questions:
      - How do I add a new allowed value to a label?
      - Can each label value have its own color?
      instructions:
      - text: Add value {value} to label {key} in space {space_ref}.
        slots:
          value: requestBody.value
          key: path.key
          space_ref: path.space_ref
      - text: Define value {value} with color {color} under label {key} in space {space_ref}.
        slots:
          value: requestBody.value
          color: requestBody.color
          key: path.key
          space_ref: path.space_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels/{key}/values/{value}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a value from a space label
      effect: destructive
      questions:
      - How do I remove one value from a label without deleting the label?
      - Can I delete a single label value in a space?
      instructions:
      - text: Delete value {value} from label {key} in space {space_ref}.
        slots:
          value: path.value
          key: path.key
          space_ref: path.space_ref
      - text: Remove {value} as an option on label {key} in {space_ref}.
        slots:
          value: path.value
          key: path.key
          space_ref: path.space_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/labels/{key}/values/{value}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a value of a space label
      effect: write
      questions:
      - Can I rename or recolor a label value?
      - How do I edit one value under a space label?
      instructions:
      - text: Rename value {value} of label {key} in space {space_ref} to {new_value}.
        slots:
          value: path.value
          key: path.key
          space_ref: path.space_ref
          new_value: requestBody.value
      - text: Change the color of value {value} on label {key} in {space_ref} to {color}.
        slots:
          value: path.value
          key: path.key
          space_ref: path.space_ref
          color: requestBody.color
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/spaces/{space_ref}/registries'].get
  update:
    x-apievangelist-phrasing:
      intent: List registries in a space
      effect: read
      questions:
      - What artifact registries exist in this space?
      - Can I list only virtual or upstream registries of a package type?
      - Can I include registries from parent or child scopes?
      instructions:
      - text: List registries in space {space_ref}.
        slots:
          space_ref: path.space_ref
      - text: List {package_type} registries of type {type} in space {space_ref}.
        slots:
          package_type: query.package_type
          type: query.type
          space_ref: path.space_ref
      - text: List registries in space {space_ref} with scope {scope}.
        slots:
          space_ref: path.space_ref
          scope: query.scope
      method: generated
      generated: '2026-09-26'