# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Akuity Platform API — Argo CD Argo CD Service API
  version: 1.0.0
extends: openapi/akuity-argocdservice-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: 155
- target: $.paths['/api/v1/argocd/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Argo CD versions
      effect: read
      questions:
      - Which Argo CD versions can I run on a managed Akuity instance?
      - What version numbers are offered when I pick a release for a new Argo CD instance?
      instructions:
      - text: Show me the Argo CD versions available for managed instances.
      - text: List the supported Argo CD release versions I can choose from.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: List Argo CD instances in an organization
      effect: read
      questions:
      - How do I see every Argo CD instance my organization runs?
      - Can I narrow the organization-wide instance list down to one workspace?
      instructions:
      - text: List all Argo CD instances in organization {org}.
        slots:
          org: path.organization_id
      - text: Show the Argo CD instances of organization {org} that sit in workspace {ws_filter}.
        slots:
          org: path.organization_id
          ws_filter: query.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Argo CD instance in an organization
      effect: write
      questions:
      - How do I spin up a new managed Argo CD instance for my organization?
      - Can I pick the Argo CD version and shard when creating an instance at the org level?
      instructions:
      - text: Create an Argo CD instance named {name} in organization {org}.
        slots:
          name: requestBody.name
          org: path.organization_id
      - text: Provision Argo CD instance {name} on version {version} for org {org}.
        slots:
          name: requestBody.name
          version: requestBody.version
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/ai-assistant-usage-stats'].post
  update:
    x-apievangelist-phrasing:
      intent: Get AI assistant usage statistics
      effect: read
      questions:
      - How much has the AI assistant been used on my Argo CD instances?
      - Can I see AI assistant usage for just one instance?
      instructions:
      - text: Get AI assistant usage stats for organization {org}.
        slots:
          org: path.organization_id
      - text: Show AI assistant usage for instance {instance} in org {org}.
        slots:
          instance: requestBody.instanceId
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/sync-operations-events'].post
  update:
    x-apievangelist-phrasing:
      intent: Query sync operation events
      effect: read
      questions:
      - Where can I find the history of sync operations across my Argo CD instances?
      - Can I page through sync events with a limit and offset and a filter?
      instructions:
      - text: Fetch sync operation events for organization {org}.
        slots:
          org: path.organization_id
      - text: Pull the first {limit} sync operation events for org {org} matching filter {filter}.
        slots:
          limit: requestBody.limit
          org: path.organization_id
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/sync-operations-stats'].post
  update:
    x-apievangelist-phrasing:
      intent: Get aggregated sync operation statistics
      effect: read
      questions:
      - How many sync operations succeeded or failed over time in my organization?
      - Can sync stats be grouped by a field or a label and bucketed by interval?
      instructions:
      - text: Get sync operation statistics for organization {org}.
        slots:
          org: path.organization_id
      - text: Chart sync stats for org {org} grouped by {group_by} per {interval}.
        slots:
          org: path.organization_id
          group_by: requestBody.groupByField
          interval: requestBody.interval
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Argo CD instance in an organization
      effect: read
      questions:
      - How do I look up the details of one Argo CD instance in my org?
      - Can I fetch an instance by its name rather than its ID?
      instructions:
      - text: Get Argo CD instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Look up instance {instance} of org {org} using id type {id_type}.
        slots:
          instance: path.id
          org: path.organization_id
          id_type: query.idType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an Argo CD instance in an organization
      effect: write
      questions:
      - How do I replace the full settings of an org-level Argo CD instance?
      - What happens when I PUT a new instance definition over an existing one?
      instructions:
      - text: Update Argo CD instance {instance} in organization {org} with a new definition.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Overwrite the configuration of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Argo CD instance from an organization
      effect: destructive
      questions:
      - How do I tear down an Argo CD instance my organization no longer needs?
      - Is deleting an org-level instance permanent?
      instructions:
      - text: Delete Argo CD instance {instance} from organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Remove org {org} instance {instance} that lives in workspace {ws_filter}.
        slots:
          org: path.organization_id
          instance: path.id
          ws_filter: query.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update an Argo CD instance in an org
      effect: write
      questions:
      - Can I change just a few fields on an org-level Argo CD instance without resending all of it?
      - How do I patch an instance addressed only by organization?
      instructions:
      - text: Patch a few settings on Argo CD instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Apply a partial change to org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/apply'].post
  update:
    x-apievangelist-phrasing:
      intent: Declaratively apply config to an org instance
      effect: write
      questions:
      - How do I push applications, projects and clusters to an Argo CD instance in one declarative apply?
      - Can an apply prune clusters or repo credentials that are no longer in my manifest?
      instructions:
      - text: Apply my declarative manifests to Argo CD instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Apply config to org {org} instance {instance} and prune clusters missing from it ({prune}).
        slots:
          org: path.organization_id
          instance: path.id
          prune: requestBody.pruneClusters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/appset/secret'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an org instance's ApplicationSet secret
      effect: read
      questions:
      - Where can I read the ApplicationSet secret of an Argo CD instance in my org?
      - Which keys are stored in the appset secret today?
      instructions:
      - text: Show the ApplicationSet secret for instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Read the appset secret keys of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/appset/secret'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an org instance's ApplicationSet secret
      effect: write
      questions:
      - How do I add a token to the ApplicationSet secret for an org-level instance?
      - Can I change only some appset secret keys?
      instructions:
      - text: Patch the ApplicationSet secret of instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Set new appset secret values {secret} on org {org} instance {instance}.
        slots:
          secret: requestBody.secret
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/clusters'].put
  update:
    x-apievangelist-phrasing:
      intent: Update cluster customizations for an org instance
      effect: write
      questions:
      - How do I change the cluster customization defaults for an Argo CD instance in my org?
      - Can I turn on the multi-cluster Kubernetes dashboard for an instance?
      instructions:
      - text: Update cluster customizations on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Set multi-cluster dashboard to {enabled} for org {org} instance {instance}.
        slots:
          enabled: requestBody.multiClusterK8sDashboardEnabled
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/config-management-plugins'].get
  update:
    x-apievangelist-phrasing:
      intent: Get config management plugins of an org instance
      effect: read
      questions:
      - Which config management plugins are set up on my org's Argo CD instance?
      - How can I review the CMP definitions an instance uses?
      instructions:
      - text: List config management plugins for instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Show the CMP setup of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/config-management-plugins'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace config management plugins on an org instance
      effect: write
      questions:
      - How do I register a new config management plugin on an org-level instance?
      - Does updating CMPs replace the whole plugin list?
      instructions:
      - text: Replace the config management plugins on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Save plugin definitions {plugins} to org {org} instance {instance}.
        slots:
          plugins: requestBody.plugins
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/css'].get
  update:
    x-apievangelist-phrasing:
      intent: Get custom UI CSS of an org instance
      effect: read
      questions:
      - What custom CSS is styling the Argo CD UI of my org's instance?
      - Can I read back the theme overrides applied to an instance?
      instructions:
      - text: Show the custom CSS for instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Fetch UI stylesheet overrides of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/css'].put
  update:
    x-apievangelist-phrasing:
      intent: Set custom UI CSS on an org instance
      effect: write
      questions:
      - How do I rebrand the Argo CD web UI of an org-level instance with my own CSS?
      - Can custom styles be pushed without touching other settings?
      instructions:
      - text: Set custom CSS {css} on instance {instance} in organization {org}.
        slots:
          css: requestBody.css
          instance: path.id
          org: path.organization_id
      - text: Replace the UI stylesheet of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export an org instance's declarative config
      effect: read
      questions:
      - How do I dump an Argo CD instance's configuration so I can keep it in Git?
      - Can I export an instance identified by name at the org level?
      instructions:
      - text: Export the declarative configuration of instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Download a config export of org {org} instance {instance} looked up by {id_type}.
        slots:
          org: path.organization_id
          instance: path.id
          id_type: query.idType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/image-updater'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Image Updater settings of an org instance
      effect: read
      questions:
      - What is the Argo CD Image Updater configured to do on my org's instance?
      - Where do I check Image Updater config, SSH config and secret keys together?
      instructions:
      - text: Show the Image Updater settings for instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Get image updater config for org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/image-updater/config'].put
  update:
    x-apievangelist-phrasing:
      intent: Update Image Updater config on an org instance
      effect: write
      questions:
      - How do I change registries or settings for the Image Updater on an org-level instance?
      - Can I pin the Image Updater to a specific version?
      instructions:
      - text: Update the Image Updater config on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Set Image Updater version {version} for org {org} instance {instance}.
        slots:
          version: requestBody.version
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/image-updater/secret'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update Image Updater secret on an org instance
      effect: write
      questions:
      - How do I give the Image Updater registry credentials on my org's instance?
      - Can I rotate one Image Updater secret key without clearing the rest?
      instructions:
      - text: Patch the Image Updater secret on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Store registry credentials {secret} in the image updater secret of org {org} instance {instance}.
        slots:
          secret: requestBody.secret
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/image-updater/ssh-config'].put
  update:
    x-apievangelist-phrasing:
      intent: Update Image Updater SSH config on an org instance
      effect: write
      questions:
      - How do I set the SSH config the Image Updater uses for Git write-back in my org?
      - Can the Image Updater SSH settings be replaced on their own?
      instructions:
      - text: Replace the SSH known-hosts and keys config used by Image Updater on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Replace image updater ssh_config for org {org} instance {instance} with {config}.
        slots:
          org: path.organization_id
          instance: path.id
          config: requestBody.config
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/notifications'].get
  update:
    x-apievangelist-phrasing:
      intent: Get notification settings of an org instance
      effect: read
      questions:
      - What notification triggers and templates are configured on my org's Argo CD instance?
      - How can I see which notification secret keys exist for an instance?
      instructions:
      - text: Show notification settings for instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Get the notifications config of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/notifications'].put
  update:
    x-apievangelist-phrasing:
      intent: Update notification config on an org instance
      effect: write
      questions:
      - How do I add a new notification trigger to an org-level Argo CD instance?
      - Does updating notification config overwrite existing templates?
      instructions:
      - text: Update the notification config on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Replace notification triggers and templates of org {org} instance {instance} with {config}.
        slots:
          org: path.organization_id
          instance: path.id
          config: requestBody.config
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/notifications/catalog'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the notification catalog of an org instance
      effect: read
      questions:
      - Which ready-made notification triggers and templates can I enable on my org's instance?
      - Is there a catalog of built-in notification templates?
      instructions:
      - text: Show the notification catalog for instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: List built-in notification templates available to org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/notifications/secret'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update notification secret on an org instance
      effect: write
      questions:
      - How do I store a webhook token for notifications on my org-level instance?
      - Can I update one notification secret key at a time?
      instructions:
      - text: Patch the notification secret on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Add notification credentials {secret} to org {org} instance {instance}.
        slots:
          secret: requestBody.secret
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/resource-customizations'].get
  update:
    x-apievangelist-phrasing:
      intent: Get resource customizations of an org instance
      effect: read
      questions:
      - What custom health checks and actions are defined for resources on my org's instance?
      - Is ignoring resource updates turned on for an instance?
      instructions:
      - text: Show resource customizations for instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Get the resource health and ignore rules of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/resource-customizations'].put
  update:
    x-apievangelist-phrasing:
      intent: Update resource customizations on an org instance
      effect: write
      questions:
      - How do I define a custom health check for a CRD on an org-level instance?
      - Can I turn on ignoring resource updates when saving customizations?
      instructions:
      - text: Update resource customizations on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Save resource rules {resources} to org {org} instance {instance}.
        slots:
          resources: requestBody.resources
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/secret'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the main Argo CD secret of an org instance
      effect: write
      questions:
      - How do I set keys in the argocd-secret for my org-level instance?
      - Can I change one Argo CD secret key without rewriting all of them?
      instructions:
      - text: Patch the argocd-secret on instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: Write secret values {secret} into the core Argo CD secret of org {org} instance {instance}.
        slots:
          secret: requestBody.secret
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{id}/transfer'].put
  update:
    x-apievangelist-phrasing:
      intent: Move an org instance to another workspace
      effect: write
      questions:
      - How do I transfer an Argo CD instance into a different workspace?
      - Can an instance change workspace without being recreated?
      instructions:
      - text: Move instance {instance} in organization {org} to workspace {new_ws}.
        slots:
          instance: path.id
          org: path.organization_id
          new_ws: requestBody.newWorkspaceId
      - text: Transfer org {org} instance {instance} into workspace {new_ws}.
        slots:
          org: path.organization_id
          instance: path.id
          new_ws: requestBody.newWorkspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List local accounts on an org instance
      effect: read
      questions:
      - Which local Argo CD accounts exist on my org-level instance?
      - How can I check which accounts are disabled?
      instructions:
      - text: List local accounts on instance {instance} in organization {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: Show every Argo CD user account of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/accounts/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a local account on an org instance
      effect: write
      questions:
      - How do I add a local Argo CD account with API key capability in my org's instance?
      - Can I disable an existing local account instead of deleting it?
      instructions:
      - text: Create or update account {account} on instance {instance} in organization {org}.
        slots:
          account: path.name
          instance: path.instance_id
          org: path.organization_id
      - text: Set account {account} on org {org} instance {instance} to disabled={disabled}.
        slots:
          account: path.name
          org: path.organization_id
          instance: path.instance_id
          disabled: requestBody.disabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/accounts/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a local account from an org instance
      effect: destructive
      questions:
      - How do I remove a local Argo CD user from my org-level instance?
      - Is removing an account from an instance reversible?
      instructions:
      - text: Delete account {account} from instance {instance} in organization {org}.
        slots:
          account: path.name
          instance: path.instance_id
          org: path.organization_id
      - text: Remove user {account} of org {org} instance {instance}.
        slots:
          account: path.name
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/accounts/{name}/password'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a local account's password on an org instance
      effect: write
      questions:
      - How do I set a specific password for a local account on my org's instance?
      - Can I choose the new password myself?
      instructions:
      - text: Set password {password} for account {account} on instance {instance} in organization {org}.
        slots:
          password: requestBody.password
          account: path.name
          instance: path.instance_id
          org: path.organization_id
      - text: Change the login password of user {account} in org {org} instance {instance}.
        slots:
          account: path.name
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/accounts/{name}/regenerate-password'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a local account password on an org instance
      effect: write
      questions:
      - Can I have a fresh random password generated for a local account on my org's instance?
      - How do I reset a forgotten local admin password?
      instructions:
      - text: Regenerate the password for account {account} on instance {instance} in organization {org}.
        slots:
          account: path.name
          instance: path.instance_id
          org: path.organization_id
      - text: Generate a new random password for user {account} of org {org} instance {instance}.
        slots:
          account: path.name
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List clusters connected to an org instance
      effect: read
      questions:
      - Which Kubernetes clusters are attached to my org's Argo CD instance?
      - How do I see all managed clusters for an instance?
      instructions:
      - text: List clusters connected to instance {instance} in organization {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: Show managed Kubernetes clusters of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a cluster to an org instance
      effect: write
      questions:
      - How do I register a new Kubernetes cluster with my org-level Argo CD instance?
      - Can a cluster be added as namespace-scoped only?
      instructions:
      - text: Add cluster {cluster_name} to instance {instance} in organization {org}.
        slots:
          cluster_name: requestBody.name
          instance: path.instance_id
          org: path.organization_id
      - text: Register cluster {cluster_name} in namespace {namespace} with org {org} instance {instance}.
        slots:
          cluster_name: requestBody.name
          namespace: requestBody.namespace
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/agent-version'].post
  update:
    x-apievangelist-phrasing:
      intent: Upgrade the agent version on org instance clusters
      effect: write
      questions:
      - How do I roll out a new Akuity agent version to clusters of my org's instance?
      - Can I upgrade every cluster's agent at once instead of listing names?
      instructions:
      - text: Upgrade agents on clusters {clusters} of instance {instance} in organization {org} to {new_version}.
        slots:
          clusters: requestBody.clusterNames
          instance: path.instance_id
          org: path.organization_id
          new_version: requestBody.newVersion
      - text: Bump every cluster agent in org {org} instance {instance} to version {new_version}.
        slots:
          org: path.organization_id
          instance: path.instance_id
          new_version: requestBody.newVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/regenerate-manifests'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate agent manifests for org instance clusters
      effect: write
      questions:
      - How do I regenerate the install manifests for clusters on an org-level instance?
      - Can manifests be regenerated for all clusters in one call?
      instructions:
      - text: Regenerate agent manifests for clusters {clusters} on instance {instance} in organization {org}.
        slots:
          clusters: requestBody.clusterNames
          instance: path.instance_id
          org: path.organization_id
      - text: Rebuild install manifests for all clusters of org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/rotate-credentials'].post
  update:
    x-apievangelist-phrasing:
      intent: Rotate cluster credentials on an org instance
      effect: write
      questions:
      - How do I rotate the credentials clusters use to talk to my org's Argo CD instance?
      - Can I rotate credentials for only selected clusters?
      instructions:
      - text: Rotate credentials for clusters {clusters} on instance {instance} in organization {org}.
        slots:
          clusters: requestBody.clusterNames
          instance: path.instance_id
          org: path.organization_id
      - text: Refresh the cluster credentials of every cluster in org {org} instance {instance}.
        slots:
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/set-maintenance-mode'].post
  update:
    x-apievangelist-phrasing:
      intent: Toggle maintenance mode on org instance clusters
      effect: write
      questions:
      - How do I pause syncing to clusters of my org's instance while I do maintenance?
      - Can maintenance mode expire automatically at a set time?
      instructions:
      - text: Put clusters {clusters} of instance {instance} in organization {org} into maintenance mode.
        slots:
          clusters: requestBody.clusterNames
          instance: path.instance_id
          org: path.organization_id
      - text: Set maintenance mode {mode} until {expiry} on all clusters of org {org} instance {instance}.
        slots:
          mode: requestBody.maintenanceMode
          expiry: requestBody.expiry
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cluster on an org instance
      effect: read
      questions:
      - How do I view the settings of one cluster connected to my org's instance?
      - Can I look up a cluster by name instead of ID?
      instructions:
      - text: Get cluster {cluster} on instance {instance} in organization {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: Look up cluster {cluster} by {id_type} in org {org} instance {instance}.
        slots:
          cluster: path.id
          id_type: query.idType
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a cluster on an org instance
      effect: write
      questions:
      - How do I change the description or data of a cluster attached to my org's instance?
      - Is there a force option when updating a cluster?
      instructions:
      - text: Edit the single cluster {cluster} attached to instance {instance} in organization {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: Change the description of cluster {cluster} in org {org} instance {instance} to {description}.
        slots:
          cluster: path.id
          org: path.organization_id
          instance: path.instance_id
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect a cluster from an org instance
      effect: destructive
      questions:
      - How do I remove a Kubernetes cluster from my org-level Argo CD instance?
      - What happens to a cluster once it is deleted from an instance?
      instructions:
      - text: Delete cluster {cluster} from instance {instance} in organization {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: Disconnect cluster {cluster} of org {org} instance {instance}.
        slots:
          cluster: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/{id}/command'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the agent install command for an org cluster
      effect: read
      questions:
      - What kubectl command do I run to install the agent on a cluster of my org's instance?
      - Can I get an offline install command that skips namespace creation?
      instructions:
      - text: Get the agent install command for cluster {cluster} on instance {instance} in organization {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: Give me the offline={offline} install command for cluster {cluster} in org {org} instance {instance}.
        slots:
          offline: query.offline
          cluster: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/{id}/info'].get
  update:
    x-apievangelist-phrasing:
      intent: Get runtime info for a cluster on an org instance
      effect: read
      questions:
      - How do I check the connection and agent status of a cluster on my org's instance?
      - What runtime info does a connected cluster report?
      instructions:
      - text: Get runtime info for cluster {cluster} on instance {instance} in organization {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: Show agent status details of cluster {cluster} in org {org} instance {instance}.
        slots:
          cluster: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/{id}/manifests'].get
  update:
    x-apievangelist-phrasing:
      intent: Download agent manifests for an org cluster
      effect: read
      questions:
      - Where can I download the agent YAML manifests for a cluster on my org's instance?
      - Are there offline-installation manifests for air-gapped clusters?
      instructions:
      - text: Download agent manifests for cluster {cluster} on instance {instance} in organization {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: Fetch offline installation YAML for cluster {cluster} in org {org} instance {instance}.
        slots:
          cluster: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_id}/clusters/{id}/support-access'].put
  update:
    x-apievangelist-phrasing:
      intent: Grant or revoke support access to an org cluster
      effect: write
      questions:
      - How do I let Akuity support access one of my org instance's clusters for a limited time?
      - Can I switch support access off again?
      instructions:
      - text: Enable support access on cluster {cluster} of instance {instance} in organization {org} for {seconds} seconds.
        slots:
          cluster: path.id
          instance: path.instance_id
          org: path.organization_id
          seconds: requestBody.durationSeconds
      - text: Set support access to {enable} for cluster {cluster} in org {org} instance {instance}.
        slots:
          enable: requestBody.enable
          cluster: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_name}/addons/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an addon by instance name
      effect: read
      questions:
      - How do I look up an addon when I only know the instance's name?
      - Can I read an addon's details through the org-level path keyed by instance name?
      instructions:
      - text: Get addon {addon} on the instance named {instance_name} in organization {org}.
        slots:
          addon: path.id
          instance_name: path.instance_name
          org: path.organization_id
      - text: Show addon {addon} for instance name {instance_name} in org {org}.
        slots:
          addon: path.id
          instance_name: path.instance_name
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/instances/{instance_name}/addons/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an addon by instance name
      effect: destructive
      questions:
      - How do I remove an addon when I address the instance by its name?
      - Is deleting an addon via the instance-name path permanent?
      instructions:
      - text: Delete addon {addon} from the instance named {instance_name} in organization {org}.
        slots:
          addon: path.id
          instance_name: path.instance_name
          org: path.organization_id
      - text: Uninstall addon {addon} off instance name {instance_name} of org {org}.
        slots:
          addon: path.id
          instance_name: path.instance_name
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/argocd/utils/cluster-ca-data'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cluster's API server CA data
      effect: read
      questions:
      - How do I retrieve the Kubernetes API server CA certificate data for a cluster?
      - Can I look up CA data by cluster name and server URL?
      instructions:
      - text: Get API server CA data for cluster {cluster_name} in organization {org}.
        slots:
          cluster_name: query.clusterName
          org: path.organization_id
      - text: Fetch the CA bundle for server {server} on instance {instance} in org {org}.
        slots:
          server: query.server
          instance: query.instanceId
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: List Argo CD instances in a workspace
      effect: read
      questions:
      - Which Argo CD instances belong to one specific workspace?
      - How do I list only a single workspace's instances?
      instructions:
      - text: List the Argo CD instances in workspace {ws} of org {org}.
        slots:
          ws: path.workspace_id
          org: path.organization_id
      - text: Show what instances workspace {ws} holds under organization {org}.
        slots:
          ws: path.workspace_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Argo CD instance in a workspace
      effect: write
      questions:
      - How do I create a new Argo CD instance directly inside a workspace?
      - Can I set the version and description when creating a workspace instance?
      instructions:
      - text: Create Argo CD instance {name} inside workspace {ws} of org {org}.
        slots:
          name: requestBody.name
          ws: path.workspace_id
          org: path.organization_id
      - text: Launch instance {name} running {version} in workspace {ws} under organization {org}.
        slots:
          name: requestBody.name
          version: requestBody.version
          ws: path.workspace_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Argo CD instance in a workspace
      effect: read
      questions:
      - How do I fetch one instance scoped to a given workspace?
      - Can a workspace instance be retrieved by name?
      instructions:
      - text: Get workspace {ws} instance {instance} in org {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      - text: Retrieve instance {instance} from workspace {ws} of organization {org} by {id_type}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
          id_type: query.idType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an Argo CD instance in a workspace
      effect: write
      questions:
      - How do I replace the whole definition of an instance that lives in a workspace?
      - Does a PUT on a workspace instance overwrite all its settings?
      instructions:
      - text: Replace the definition of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Save a full new spec for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Argo CD instance from a workspace
      effect: destructive
      questions:
      - How do I delete an Argo CD instance that belongs to a workspace?
      - Can a workspace-scoped instance be recovered after deletion?
      instructions:
      - text: Delete instance {instance} from workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Tear down workspace {ws} Argo CD instance {instance} in organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update an Argo CD instance in a workspace
      effect: write
      questions:
      - Can I tweak a couple of fields on a workspace instance without a full replace?
      - How do I patch an instance addressed by workspace?
      instructions:
      - text: Patch selected fields on instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Make a partial edit to workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/apply'].post
  update:
    x-apievangelist-phrasing:
      intent: Declaratively apply config to a workspace instance
      effect: write
      questions:
      - How do I apply a bundle of applications, AppProjects and clusters to a workspace instance?
      - Can a workspace apply prune resource types that are missing from my manifests?
      instructions:
      - text: Apply declarative manifests to instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Push GitOps config to workspace {ws} instance {instance} in organization {org}, pruning types {types}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
          types: requestBody.pruneResourceTypes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/appset/secret'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace instance's ApplicationSet secret
      effect: read
      questions:
      - Where do I read the ApplicationSet secret of an instance inside a workspace?
      - What appset secret keys does a workspace instance hold?
      instructions:
      - text: Read the appset secret of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Display ApplicationSet secret entries for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/appset/secret'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a workspace instance's ApplicationSet secret
      effect: write
      questions:
      - How do I add an SCM token to the ApplicationSet secret of a workspace instance?
      - Can workspace appset secret keys be changed individually?
      instructions:
      - text: Patch the appset secret of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Write ApplicationSet secret values {secret} to workspace {ws} instance {instance} under organization {org}.
        slots:
          secret: requestBody.secret
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/clusters'].put
  update:
    x-apievangelist-phrasing:
      intent: Update cluster customizations for a workspace instance
      effect: write
      questions:
      - How do I change cluster customization defaults for an instance in a workspace?
      - Can I enable the multi-cluster K8s dashboard on a workspace instance?
      instructions:
      - text: Update cluster customizations for instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Turn the multi-cluster dashboard {enabled} on workspace {ws} instance {instance} under organization {org}.
        slots:
          enabled: requestBody.multiClusterK8sDashboardEnabled
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/config-management-plugins'].get
  update:
    x-apievangelist-phrasing:
      intent: Get config management plugins of a workspace instance
      effect: read
      questions:
      - Which CMP plugins are installed on an instance inside my workspace?
      - Can I review workspace instance plugin definitions?
      instructions:
      - text: Show config management plugins of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Get CMP definitions for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/config-management-plugins'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace config management plugins on a workspace instance
      effect: write
      questions:
      - How do I add a CMP sidecar plugin to an instance in a workspace?
      - Will saving plugins on a workspace instance replace the existing list?
      instructions:
      - text: Replace config management plugins of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Store CMP plugins {plugins} on workspace {ws} instance {instance} under organization {org}.
        slots:
          plugins: requestBody.plugins
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/css'].get
  update:
    x-apievangelist-phrasing:
      intent: Get custom UI CSS of a workspace instance
      effect: read
      questions:
      - What custom stylesheet is applied to the UI of a workspace instance?
      - Can I read the CSS theme of an instance inside a workspace?
      instructions:
      - text: Get the UI CSS of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show styling overrides for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/css'].put
  update:
    x-apievangelist-phrasing:
      intent: Set custom UI CSS on a workspace instance
      effect: write
      questions:
      - How do I apply my company colors to the Argo CD UI of a workspace instance?
      - Can I update only the CSS of an instance in a workspace?
      instructions:
      - text: Apply CSS {css} to instance {instance} in workspace {ws} of org {org}.
        slots:
          css: requestBody.css
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Restyle the web UI of workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/export'].get
  update:
    x-apievangelist-phrasing:
      intent: Export a workspace instance's declarative config
      effect: read
      questions:
      - How do I export the configuration of an instance inside a workspace for backup?
      - Can I export a workspace instance addressed by name?
      instructions:
      - text: Export the config of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Back up workspace {ws} instance {instance} under organization {org} as declarative YAML, identified by {id_type}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
          id_type: query.idType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/image-updater'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Image Updater settings of a workspace instance
      effect: read
      questions:
      - How is the Image Updater configured on an instance in my workspace?
      - Where do I see Image Updater secrets and SSH config for a workspace instance?
      instructions:
      - text: Get Image Updater settings of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show image updater configuration for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/image-updater/config'].put
  update:
    x-apievangelist-phrasing:
      intent: Update Image Updater config on a workspace instance
      effect: write
      questions:
      - How do I change the Image Updater registries for a workspace instance?
      - Can I choose which Image Updater version a workspace instance runs?
      instructions:
      - text: Update Image Updater config of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Run image updater {version} with config {config} on workspace {ws} instance {instance} under organization {org}.
        slots:
          version: requestBody.version
          config: requestBody.config
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/image-updater/secret'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update Image Updater secret on a workspace instance
      effect: write
      questions:
      - How do I add registry pull credentials for the Image Updater in a workspace instance?
      - Can workspace Image Updater secret keys be patched one at a time?
      instructions:
      - text: Patch the Image Updater secret of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Save image updater credentials {secret} for workspace {ws} instance {instance} under organization {org}.
        slots:
          secret: requestBody.secret
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/image-updater/ssh-config'].put
  update:
    x-apievangelist-phrasing:
      intent: Update Image Updater SSH config on a workspace instance
      effect: write
      questions:
      - How do I configure SSH for Image Updater Git write-back on a workspace instance?
      - Can the SSH config of a workspace Image Updater be replaced alone?
      instructions:
      - text: Update the Image Updater SSH config of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Set image updater ssh settings {config} on workspace {ws} instance {instance} under organization {org}.
        slots:
          config: requestBody.config
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/notifications'].get
  update:
    x-apievangelist-phrasing:
      intent: Get notification settings of a workspace instance
      effect: read
      questions:
      - Which notification triggers and templates does a workspace instance use?
      - How do I check notification secret keys on an instance inside a workspace?
      instructions:
      - text: Get notification settings of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show notifications setup for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/notifications'].put
  update:
    x-apievangelist-phrasing:
      intent: Update notification config on a workspace instance
      effect: write
      questions:
      - How do I add a new notification trigger to an instance in a workspace?
      - Will updating a workspace instance's notification config replace its templates?
      instructions:
      - text: Update notification config of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Save notification triggers {config} on workspace {ws} instance {instance} under organization {org}.
        slots:
          config: requestBody.config
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/notifications/catalog'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the notification catalog of a workspace instance
      effect: read
      questions:
      - What prebuilt notification templates can a workspace instance enable?
      - Is a catalog of notification triggers available for instances in a workspace?
      instructions:
      - text: Show the notification catalog of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Browse ready-made notification triggers for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/notifications/secret'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update notification secret on a workspace instance
      effect: write
      questions:
      - How do I store a notification service token on an instance in a workspace?
      - Can I patch a single notification secret key for a workspace instance?
      instructions:
      - text: Patch the notification secret of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Put notification tokens {secret} into workspace {ws} instance {instance} under organization {org}.
        slots:
          secret: requestBody.secret
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/resource-customizations'].get
  update:
    x-apievangelist-phrasing:
      intent: Get resource customizations of a workspace instance
      effect: read
      questions:
      - Which custom resource health checks does a workspace instance define?
      - Is ignore-resource-updates enabled on an instance in my workspace?
      instructions:
      - text: Get resource customizations of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show resource health overrides for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/resource-customizations'].put
  update:
    x-apievangelist-phrasing:
      intent: Update resource customizations on a workspace instance
      effect: write
      questions:
      - How do I add a custom health check for a CRD on a workspace instance?
      - Can I switch on ignoring resource updates for an instance in a workspace?
      instructions:
      - text: Update resource customizations of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Set ignore resource updates to {enabled} on workspace {ws} instance {instance} under organization {org}.
        slots:
          enabled: requestBody.ignoreResourceUpdatesEnabled
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/secret'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update the main Argo CD secret of a workspace instance
      effect: write
      questions:
      - How do I set keys in argocd-secret for an instance inside a workspace?
      - Can I patch one core secret key on a workspace instance?
      instructions:
      - text: Patch argocd-secret of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
      - text: Store core secret values {secret} on workspace {ws} instance {instance} under organization {org}.
        slots:
          secret: requestBody.secret
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{id}/transfer'].put
  update:
    x-apievangelist-phrasing:
      intent: Transfer a workspace instance to another workspace
      effect: write
      questions:
      - How do I move an instance out of its current workspace into another one?
      - Can a workspace instance be reassigned without rebuilding it?
      instructions:
      - text: Move instance {instance} from workspace {ws} of org {org} into workspace {new_ws}.
        slots:
          instance: path.id
          ws: path.workspace_id
          org: path.organization_id
          new_ws: requestBody.newWorkspaceId
      - text: Reassign workspace {ws} instance {instance} under organization {org} to target workspace {new_ws}.
        slots:
          ws: path.workspace_id
          instance: path.id
          org: path.organization_id
          new_ws: requestBody.newWorkspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List local accounts on a workspace instance
      effect: read
      questions:
      - Which local Argo CD accounts exist on an instance inside a workspace?
      - How do I audit local users of a workspace instance?
      instructions:
      - text: List local accounts of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show all Argo CD users for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/accounts/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a local account on a workspace instance
      effect: write
      questions:
      - How do I add a local Argo CD user to an instance in a workspace?
      - Can I grant login or API key capabilities to a workspace instance account?
      instructions:
      - text: Create or update account {account} on instance {instance} in workspace {ws} of org {org}.
        slots:
          account: path.name
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Give user {account} capabilities {caps} on workspace {ws} instance {instance} under organization {org}.
        slots:
          account: path.name
          caps: requestBody.capabilities
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/accounts/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a local account from a workspace instance
      effect: destructive
      questions:
      - How do I remove a local user from an instance inside a workspace?
      - Can a deleted workspace instance account be restored?
      instructions:
      - text: Delete account {account} from instance {instance} in workspace {ws} of org {org}.
        slots:
          account: path.name
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Drop local user {account} on workspace {ws} instance {instance} under organization {org}.
        slots:
          account: path.name
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/accounts/{name}/password'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a local account's password on a workspace instance
      effect: write
      questions:
      - How do I set a chosen password for a local user on a workspace instance?
      - Can I change a workspace instance account's password to a value I pick?
      instructions:
      - text: Set password {password} for account {account} on instance {instance} in workspace {ws} of org {org}.
        slots:
          password: requestBody.password
          account: path.name
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Change user {account}'s password on workspace {ws} instance {instance} under organization {org}.
        slots:
          account: path.name
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/accounts/{name}/regenerate-password'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a local account password on a workspace instance
      effect: write
      questions:
      - Can a random new password be generated for a local user of a workspace instance?
      - How do I reset a local account password on an instance in a workspace?
      instructions:
      - text: Regenerate the password of account {account} on instance {instance} in workspace {ws} of org {org}.
        slots:
          account: path.name
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Issue a fresh random password to user {account} on workspace {ws} instance {instance} under organization {org}.
        slots:
          account: path.name
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-errors/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: List errors for an addon in a workspace instance
      effect: read
      questions:
      - Why is an addon failing on my workspace instance, and what errors has it logged?
      - Can I page through addon errors with limit and offset?
      instructions:
      - text: List errors for addon {addon} on instance {instance} in workspace {ws} of org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show the first {limit} addon errors for {addon} in workspace {ws} instance {instance} under organization {org}.
        slots:
          limit: query.limit
          addon: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-marketplace-installs'].post
  update:
    x-apievangelist-phrasing:
      intent: Install a marketplace addon on a workspace instance
      effect: write
      questions:
      - How do I install an addon from the marketplace onto an instance in my workspace?
      - What config do I pass when installing a marketplace addon?
      instructions:
      - text: Install a marketplace addon with config {config} on instance {instance} in workspace {ws} of org {org}.
        slots:
          config: requestBody.config
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Add a marketplace addon to workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-marketplace-installs/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a marketplace addon install in a workspace
      effect: write
      questions:
      - How do I change dependencies of a marketplace addon already installed in a workspace instance?
      - Can I force or refresh a marketplace install when updating it?
      instructions:
      - text: Update marketplace install {install} on instance {instance} in workspace {ws} of org {org}.
        slots:
          install: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Refresh={refresh} marketplace install {install} with dependencies {deps} in workspace {ws} instance {instance} of organization {org}.
        slots:
          refresh: requestBody.refresh
          install: path.id
          deps: requestBody.dependencies
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-marketplace-installs/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a marketplace addon install in a workspace
      effect: destructive
      questions:
      - How do I uninstall a marketplace addon from an instance in a workspace?
      - Is removing a marketplace install from a workspace instance permanent?
      instructions:
      - text: Delete marketplace install {install} from instance {instance} in workspace {ws} of org {org}.
        slots:
          install: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Uninstall marketplace addon install {install} on workspace {ws} instance {instance} under organization {org}.
        slots:
          install: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-repos'].get
  update:
    x-apievangelist-phrasing:
      intent: List addon repos of a workspace instance
      effect: read
      questions:
      - Which addon Git repositories are registered on an instance in my workspace?
      - Can I page through the addon repos list?
      instructions:
      - text: List addon repos of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show {limit} addon repositories starting at {offset} for workspace {ws} instance {instance} under organization {org}.
        slots:
          limit: query.limit
          offset: query.offset
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-repos'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an addon repo on a workspace instance
      effect: write
      questions:
      - How do I connect a Git repo of addons to an instance in a workspace?
      - What goes in the spec when adding an addon repository?
      instructions:
      - text: Add an addon repo with spec {spec} to instance {instance} in workspace {ws} of org {org}.
        slots:
          spec: requestBody.spec
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Register a new addon repository on workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-repos/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an addon repo on a workspace instance
      effect: read
      questions:
      - How do I check the status and spec of one addon repo in a workspace instance?
      - Can I see a single addon repository's details?
      instructions:
      - text: Get addon repo {repo} on instance {instance} in workspace {ws} of org {org}.
        slots:
          repo: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show addon repository {repo} for workspace {ws} instance {instance} under organization {org}.
        slots:
          repo: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-repos/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an addon repo from a workspace instance
      effect: destructive
      questions:
      - How do I disconnect an addon repository from an instance in a workspace?
      - Does deleting an addon repo in a workspace also drop its addons?
      instructions:
      - text: Delete addon repo {repo} from instance {instance} in workspace {ws} of org {org}.
        slots:
          repo: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Unregister addon repository {repo} on workspace {ws} instance {instance} under organization {org}.
        slots:
          repo: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-repos/{id}/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh an addon repo on a workspace instance
      effect: write
      questions:
      - How do I force a re-sync of an addon repo so new addons show up in my workspace instance?
      - Can an addon repository be refreshed on demand?
      instructions:
      - text: Refresh addon repo {repo} on instance {instance} in workspace {ws} of org {org}.
        slots:
          repo: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Re-scan addon repository {repo} for workspace {ws} instance {instance} under organization {org}.
        slots:
          repo: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addons'].get
  update:
    x-apievangelist-phrasing:
      intent: List addons on a workspace instance
      effect: read
      questions:
      - Which addons are installed on an instance inside my workspace?
      - Can the workspace addon list be paginated?
      instructions:
      - text: List addons on instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show {limit} installed addons for workspace {ws} instance {instance} under organization {org}.
        slots:
          limit: query.limit
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addons/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an addon on a workspace instance
      effect: read
      questions:
      - How do I see the details and status of one addon in a workspace instance?
      - Can I look up a workspace addon when I also know the instance name?
      instructions:
      - text: Show installed addon {addon} and its status on instance {instance} in workspace {ws} of org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show addon {addon} details for workspace {ws} instance {instance} under organization {org}.
        slots:
          addon: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addons/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an addon's definition on a workspace instance
      effect: write
      questions:
      - How do I replace an addon's full definition on an instance in my workspace?
      - Does a PUT on a workspace addon overwrite every field?
      instructions:
      - text: Update addon {addon} on instance {instance} in workspace {ws} of org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Overwrite the definition of addon {addon} for workspace {ws} instance {instance} under organization {org}.
        slots:
          addon: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addons/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an addon from a workspace instance
      effect: destructive
      questions:
      - How do I remove an addon from an instance inside my workspace?
      - Is deleting a workspace addon irreversible?
      instructions:
      - text: Uninstall the addon {addon} itself from instance {instance} in workspace {ws} of org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Remove installed addon {addon} on workspace {ws} instance {instance} under organization {org}.
        slots:
          addon: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addons/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update an addon on a workspace instance
      effect: write
      questions:
      - Can I change a single field on an addon in my workspace instance?
      - How do I patch an addon without replacing it?
      instructions:
      - text: Patch addon {addon} on instance {instance} in workspace {ws} of org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Tweak some fields of addon {addon} for workspace {ws} instance {instance} under organization {org}.
        slots:
          addon: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addons/{id}/clear-operation-history'].patch
  update:
    x-apievangelist-phrasing:
      intent: Clear an addon's operation history in a workspace
      effect: write
      questions:
      - How do I wipe the operation history shown for an addon in my workspace instance?
      - Can old addon status source history be cleared?
      instructions:
      - text: Clear the operation history of addon {addon} on instance {instance} in workspace {ws} of org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Reset status source history for addon {addon} in workspace {ws} instance {instance} under organization {org}.
        slots:
          addon: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addons/{id}/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh an addon on a workspace instance
      effect: write
      questions:
      - How do I trigger a refresh of one addon on an instance in my workspace?
      - Can I make an addon re-read its source right now?
      instructions:
      - text: Trigger a refresh of installed addon {addon} on instance {instance} in workspace {ws} of org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Re-sync addon {addon} from its source for workspace {ws} instance {instance} under organization {org}.
        slots:
          addon: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: List clusters connected to a workspace instance
      effect: read
      questions:
      - Which clusters are attached to an Argo CD instance inside a workspace?
      - How do I list managed clusters of a workspace instance?
      instructions:
      - text: List clusters of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show connected Kubernetes clusters for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a cluster to a workspace instance
      effect: write
      questions:
      - How do I add a Kubernetes cluster to an instance in my workspace?
      - Can I upsert a cluster that might already exist on a workspace instance?
      instructions:
      - text: Add cluster {cluster_name} to instance {instance} in workspace {ws} of org {org}.
        slots:
          cluster_name: requestBody.name
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Upsert={upsert} cluster {cluster_name} on workspace {ws} instance {instance} under organization {org}.
        slots:
          upsert: requestBody.upsert
          cluster_name: requestBody.name
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/agent-version'].post
  update:
    x-apievangelist-phrasing:
      intent: Upgrade the agent version on workspace clusters
      effect: write
      questions:
      - How do I upgrade the agent on clusters of an instance inside my workspace?
      - Can a workspace instance upgrade all cluster agents at once?
      instructions:
      - text: Upgrade agents on clusters {clusters} of instance {instance} in workspace {ws} of org {org} to {new_version}.
        slots:
          clusters: requestBody.clusterNames
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
          new_version: requestBody.newVersion
      - text: Move all cluster agents in workspace {ws} instance {instance} under organization {org} to version {new_version}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
          new_version: requestBody.newVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/regenerate-manifests'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate agent manifests for workspace clusters
      effect: write
      questions:
      - How do I regenerate agent install manifests for clusters of a workspace instance?
      - Can I regenerate manifests for just a few named clusters in a workspace?
      instructions:
      - text: Regenerate manifests for clusters {clusters} on instance {instance} in workspace {ws} of org {org}.
        slots:
          clusters: requestBody.clusterNames
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Rebuild agent manifests for every cluster in workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/rotate-credentials'].post
  update:
    x-apievangelist-phrasing:
      intent: Rotate cluster credentials on a workspace instance
      effect: write
      questions:
      - How do I rotate cluster credentials for an instance in my workspace?
      - Can a workspace instance rotate credentials for every cluster at once?
      instructions:
      - text: Rotate credentials for clusters {clusters} on instance {instance} in workspace {ws} of org {org}.
        slots:
          clusters: requestBody.clusterNames
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Cycle cluster credentials across workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/set-maintenance-mode'].post
  update:
    x-apievangelist-phrasing:
      intent: Toggle maintenance mode on workspace clusters
      effect: write
      questions:
      - How do I put clusters of a workspace instance into maintenance mode?
      - Can workspace cluster maintenance mode end automatically at an expiry time?
      instructions:
      - text: Enable maintenance mode on clusters {clusters} of instance {instance} in workspace {ws} of org {org}.
        slots:
          clusters: requestBody.clusterNames
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Switch maintenance {mode} until {expiry} for all clusters in workspace {ws} instance {instance} under organization {org}.
        slots:
          mode: requestBody.maintenanceMode
          expiry: requestBody.expiry
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cluster on a workspace instance
      effect: read
      questions:
      - How do I view one cluster attached to an instance in my workspace?
      - Can I look up a workspace cluster by its name?
      instructions:
      - text: Get cluster {cluster} on instance {instance} in workspace {ws} of org {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Find cluster {cluster} by {id_type} for workspace {ws} instance {instance} under organization {org}.
        slots:
          cluster: path.id
          id_type: query.idType
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a cluster on a workspace instance
      effect: write
      questions:
      - How do I edit a cluster's data on an instance in my workspace?
      - Can I force-update a workspace cluster?
      instructions:
      - text: Update cluster {cluster} on instance {instance} in workspace {ws} of org {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Set new data {data} on cluster {cluster} for workspace {ws} instance {instance} under organization {org}.
        slots:
          data: requestBody.data
          cluster: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect a cluster from a workspace instance
      effect: destructive
      questions:
      - How do I remove a cluster from an instance in my workspace?
      - Is disconnecting a workspace cluster permanent?
      instructions:
      - text: Delete cluster {cluster} from instance {instance} in workspace {ws} of org {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Detach Kubernetes cluster {cluster} on workspace {ws} instance {instance} under organization {org}.
        slots:
          cluster: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/{id}/command'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the agent install command for a workspace cluster
      effect: read
      questions:
      - What command installs the agent on a cluster of my workspace instance?
      - Can the workspace install command skip creating the namespace?
      instructions:
      - text: Get the install command for cluster {cluster} on instance {instance} in workspace {ws} of org {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Print a kubectl apply command of type {type} for cluster {cluster} in workspace {ws} instance {instance} under organization {org}.
        slots:
          type: query.type
          cluster: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/{id}/info'].get
  update:
    x-apievangelist-phrasing:
      intent: Get runtime info for a workspace cluster
      effect: read
      questions:
      - How do I check a workspace cluster's agent health and connection info?
      - What status does a cluster in my workspace instance report?
      instructions:
      - text: Get runtime info of cluster {cluster} on instance {instance} in workspace {ws} of org {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show connection status for cluster {cluster} in workspace {ws} instance {instance} under organization {org}.
        slots:
          cluster: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/{id}/manifests'].get
  update:
    x-apievangelist-phrasing:
      intent: Download agent manifests for a workspace cluster
      effect: read
      questions:
      - Where do I get the agent YAML for a cluster of an instance in my workspace?
      - Can I download offline manifests for an air-gapped workspace cluster?
      instructions:
      - text: Download manifests for cluster {cluster} on instance {instance} in workspace {ws} of org {org}.
        slots:
          cluster: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Get air-gapped agent YAML for cluster {cluster} in workspace {ws} instance {instance} under organization {org}.
        slots:
          cluster: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters/{id}/support-access'].put
  update:
    x-apievangelist-phrasing:
      intent: Grant or revoke support access to a workspace cluster
      effect: write
      questions:
      - How do I give support engineers temporary access to a cluster in my workspace instance?
      - Can workspace cluster support access be turned off?
      instructions:
      - text: Grant support access to cluster {cluster} of instance {instance} in workspace {ws} of org {org} for {seconds} seconds.
        slots:
          cluster: path.id
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
          seconds: requestBody.durationSeconds
      - text: Toggle support access {enable} on cluster {cluster} in workspace {ws} instance {instance} under organization {org}.
        slots:
          enable: requestBody.enable
          cluster: path.id
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/list-addon-marketplace-installs'].post
  update:
    x-apievangelist-phrasing:
      intent: List marketplace addon installs in a workspace
      effect: read
      questions:
      - Which marketplace addons have been installed on my workspace instance?
      - Can I filter and page marketplace installs?
      instructions:
      - text: List marketplace installs on instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show {limit} marketplace addon installs matching {filter} for workspace {ws} instance {instance} under organization {org}.
        slots:
          limit: requestBody.limit
          filter: requestBody.filter
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/managed-secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List managed secrets on a workspace instance
      effect: read
      questions:
      - Which managed secrets are stored on an instance in my workspace?
      - How do I see the managed secrets of a workspace instance?
      instructions:
      - text: List managed secrets of instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show every managed secret for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/managed-secrets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a managed secret on a workspace instance
      effect: write
      questions:
      - How do I create a managed secret for an instance in my workspace?
      - What data do I supply for a new managed secret?
      instructions:
      - text: Create a managed secret with data {data} on instance {instance} in workspace {ws} of org {org}.
        slots:
          data: requestBody.managedSecretData
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Add a new managed secret to workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/managed-secrets/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a managed secret on a workspace instance
      effect: write
      questions:
      - How do I replace the contents of an existing managed secret on my workspace instance?
      - Does a full update of a managed secret overwrite all its data?
      instructions:
      - text: Update managed secret {secret_name} on instance {instance} in workspace {ws} of org {org}.
        slots:
          secret_name: path.name
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Overwrite managed secret {secret_name} with data {data} for workspace {ws} instance {instance} under organization {org}.
        slots:
          secret_name: path.name
          data: requestBody.managedSecretData
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/managed-secrets/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a managed secret from a workspace instance
      effect: destructive
      questions:
      - How do I delete a managed secret from an instance in my workspace?
      - Can a deleted managed secret be recovered?
      instructions:
      - text: Delete managed secret {secret_name} from instance {instance} in workspace {ws} of org {org}.
        slots:
          secret_name: path.name
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Remove managed secret {secret_name} on workspace {ws} instance {instance} under organization {org}.
        slots:
          secret_name: path.name
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/managed-secrets/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update a managed secret in a workspace
      effect: write
      questions:
      - Can I change only some keys of a managed secret on my workspace instance?
      - How do I patch a managed secret instead of replacing it?
      instructions:
      - text: Patch managed secret {secret_name} on instance {instance} in workspace {ws} of org {org}.
        slots:
          secret_name: path.name
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Merge keys {data} into managed secret {secret_name} for workspace {ws} instance {instance} under organization {org}.
        slots:
          data: requestBody.managedSecretData
          secret_name: path.name
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/repos'].get
  update:
    x-apievangelist-phrasing:
      intent: List Git repos connected to a workspace instance
      effect: read
      questions:
      - Which Git repositories are connected to an Argo CD instance in my workspace?
      - How do I see source repos registered on a workspace instance?
      instructions:
      - text: List the Argo CD source Git repos connected to instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Show the connected source repositories for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/repos'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a Git repo to a workspace instance
      effect: write
      questions:
      - How do I connect a new Git repository to an Argo CD instance in my workspace?
      - What repo data do I send when adding a source repository?
      instructions:
      - text: Connect a repo with data {data} to instance {instance} in workspace {ws} of org {org}.
        slots:
          data: requestBody.data
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Register a source Git repository on workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/orgs/{organization_id}/workspaces/{workspace_id}/argocd/utils/cluster-ca-data'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cluster's API server CA data in a workspace
      effect: read
      questions:
      - How do I get the API server CA certificate for a cluster within a workspace?
      - Can I look up workspace cluster CA data by server URL?
      instructions:
      - text: Get CA data for cluster {cluster_name} in workspace {ws} of org {org}.
        slots:
          cluster_name: query.clusterName
          ws: path.workspace_id
          org: path.organization_id
      - text: Fetch the API server certificate authority for server {server} under workspace {ws} in organization {org}.
        slots:
          server: query.server
          ws: path.workspace_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stream/orgs/{organization_id}/argocd/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream live instance changes in an organization
      effect: read
      questions:
      - Can I subscribe to a live stream of Argo CD instance changes across my org?
      - Is there a way to watch one instance for status updates in real time?
      instructions:
      - text: Watch for live instance updates across organization {org}.
        slots:
          org: path.organization_id
      - text: Stream real-time changes to instance {instance} in org {org}.
        slots:
          instance: query.instanceId
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stream/orgs/{organization_id}/argocd/instances/{instance_id}/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream live cluster changes for an org instance
      effect: read
      questions:
      - How do I get real-time updates as clusters of my org's instance change state?
      - Can I watch only a range of cluster names?
      instructions:
      - text: Watch live cluster events for instance {instance} in organization {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: Stream updates for cluster {cluster} of org {org} instance {instance}.
        slots:
          cluster: query.clusterId
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stream/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream live instance changes in a workspace
      effect: read
      questions:
      - Can I get a real-time feed of instance changes inside one workspace?
      - Is there a streaming endpoint for a workspace's Argo CD instances?
      instructions:
      - text: Subscribe to instance change events in workspace {ws} of org {org}.
        slots:
          ws: path.workspace_id
          org: path.organization_id
      - text: Follow live status of instance {instance} within workspace {ws} under organization {org}.
        slots:
          instance: query.instanceId
          ws: path.workspace_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stream/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-marketplace-installs'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream marketplace install changes in a workspace
      effect: read
      questions:
      - How can I follow marketplace addon installs in real time on a workspace instance?
      - Is there a live feed of marketplace install progress?
      instructions:
      - text: Watch marketplace installs on instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Stream marketplace addon install events for workspace {ws} instance {instance} under organization {org}.
        slots:
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stream/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addon-repos'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream addon repo changes in a workspace
      effect: read
      questions:
      - Can I watch addon repositories of a workspace instance for live changes?
      - How do I follow one addon repo's sync status as it happens?
      instructions:
      - text: Watch addon repos on instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Stream live updates to addon repository {repo} in workspace {ws} instance {instance} under organization {org}.
        slots:
          repo: query.addonRepoId
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stream/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/addons'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream addon changes in a workspace instance
      effect: read
      questions:
      - How do I get live addon status updates on an instance in my workspace?
      - Can I watch a single addon for changes in real time?
      instructions:
      - text: Watch addons on instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Stream live changes to addon {addon} for workspace {ws} instance {instance} under organization {org}.
        slots:
          addon: query.addonId
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/stream/orgs/{organization_id}/workspaces/{workspace_id}/argocd/instances/{instance_id}/clusters'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream live cluster changes for a workspace instance
      effect: read
      questions:
      - Can I follow cluster connection changes live for an instance in my workspace?
      - Is there a streaming feed of workspace instance clusters filtered by name range?
      instructions:
      - text: Watch clusters on instance {instance} in workspace {ws} of org {org}.
        slots:
          instance: path.instance_id
          ws: path.workspace_id
          org: path.organization_id
      - text: Stream cluster {cluster} status for workspace {ws} instance {instance} under organization {org}.
        slots:
          cluster: query.clusterId
          ws: path.workspace_id
          instance: path.instance_id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-errors/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: List addon errors via the addons extension
      effect: read
      questions:
      - From inside the Argo CD addons extension, how do I see what errors an addon hit?
      - Can the extension's addon error list be paged?
      instructions:
      - text: Using the addons extension API, list errors for addon {addon} on instance {instance} in org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: Pull {limit} extension addon errors for {addon} on org {org} instance {instance}.
        slots:
          limit: query.limit
          addon: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-marketplace-installs'].post
  update:
    x-apievangelist-phrasing:
      intent: Install a marketplace addon via the extension
      effect: write
      questions:
      - Can I install a marketplace addon from the addons extension without naming a workspace?
      - What config does the extension's marketplace install take?
      instructions:
      - text: Through the addons extension, install a marketplace addon on instance {instance} in org {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension install: add marketplace addon config {config} to org {org} instance {instance}.'
        slots:
          config: requestBody.config
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-marketplace-installs/{id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a marketplace install via the extension
      effect: write
      questions:
      - From the addons extension, how do I change a marketplace install's dependencies?
      - Can the extension force-refresh a marketplace install?
      instructions:
      - text: Via the addons extension, update marketplace install {install} on instance {instance} in org {org}.
        slots:
          install: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: force={force} update of marketplace install {install} for org {org} instance {instance}.'
        slots:
          force: requestBody.force
          install: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-marketplace-installs/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a marketplace install via the extension
      effect: destructive
      questions:
      - Can I uninstall a marketplace addon from the addons extension endpoint?
      - Is an extension-side marketplace uninstall permanent?
      instructions:
      - text: Via the addons extension, delete marketplace install {install} from instance {instance} in org {org}.
        slots:
          install: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: uninstall marketplace entry {install} off org {org} instance {instance}.'
        slots:
          install: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-repos'].get
  update:
    x-apievangelist-phrasing:
      intent: List addon repos via the addons extension
      effect: read
      questions:
      - From the addons extension, which addon repos does an instance have?
      - Can I filter the extension's addon repo list by workspace?
      instructions:
      - text: Using the addons extension, list addon repos on instance {instance} in org {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: show addon repositories of org {org} instance {instance} in workspace {ws_filter}.'
        slots:
          org: path.organization_id
          instance: path.instance_id
          ws_filter: query.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-repos'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an addon repo via the extension
      effect: write
      questions:
      - Can I add an addon Git repo from within the addons extension?
      - What spec does the extension need to register an addon repository?
      instructions:
      - text: Via the addons extension, add an addon repo with spec {spec} to instance {instance} in org {org}.
        slots:
          spec: requestBody.spec
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: connect a new addon repository to org {org} instance {instance}.'
        slots:
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-repos/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an addon repo via the addons extension
      effect: read
      questions:
      - From the addons extension, how do I read one addon repo's details?
      - Does the extension show an addon repository's sync status?
      instructions:
      - text: Using the addons extension, get addon repo {repo} on instance {instance} in org {org}.
        slots:
          repo: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: fetch addon repository {repo} of org {org} instance {instance}.'
        slots:
          repo: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-repos/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an addon repo via the addons extension
      effect: destructive
      questions:
      - Can I disconnect an addon repo from the addons extension?
      - What is lost when the extension deletes an addon repository?
      instructions:
      - text: Via the addons extension, delete addon repo {repo} from instance {instance} in org {org}.
        slots:
          repo: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: remove addon repository {repo} off org {org} instance {instance}.'
        slots:
          repo: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addon-repos/{id}/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh an addon repo via the addons extension
      effect: write
      questions:
      - From the addons extension, how do I re-sync an addon repository?
      - Can the extension pick up new addons from a repo immediately?
      instructions:
      - text: Using the addons extension, refresh addon repo {repo} on instance {instance} in org {org}.
        slots:
          repo: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: rescan addon repository {repo} for org {org} instance {instance}.'
        slots:
          repo: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addons'].get
  update:
    x-apievangelist-phrasing:
      intent: List addons via the addons extension
      effect: read
      questions:
      - From the addons extension, which addons are installed on an instance?
      - Can I page through addons from the extension endpoint?
      instructions:
      - text: Using the addons extension, list addons on instance {instance} in org {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: show {limit} installed addons for org {org} instance {instance}.'
        slots:
          limit: query.limit
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addons/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an addon via the addons extension
      effect: read
      questions:
      - From the addons extension, how do I look at one addon's status?
      - Can the extension fetch an addon when I pass the instance name too?
      instructions:
      - text: Using the addons extension, show installed addon {addon} and its status for instance {instance} in org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: read addon {addon} details for org {org} instance {instance}.'
        slots:
          addon: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addons/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an addon via the addons extension
      effect: write
      questions:
      - From the addons extension, how do I overwrite an addon's full definition?
      - Does the extension's addon PUT replace every field?
      instructions:
      - text: Via the addons extension, replace addon {addon} on instance {instance} in org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: save a new definition {definition} for addon {addon} on org {org} instance {instance}.'
        slots:
          definition: requestBody.addon
          addon: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addons/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an addon via the addons extension
      effect: destructive
      questions:
      - Can I delete an addon directly from the addons extension?
      - Is an addon removed through the extension gone for good?
      instructions:
      - text: Via the addons extension, uninstall the addon {addon} itself from instance {instance} in org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: uninstall addon {addon} off org {org} instance {instance}.'
        slots:
          addon: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addons/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update an addon via the extension
      effect: write
      questions:
      - From the addons extension, can I patch just part of an addon?
      - How does the extension apply a partial addon change?
      instructions:
      - text: Via the addons extension, patch addon {addon} on instance {instance} in org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: make a partial edit to addon {addon} for org {org} instance {instance}.'
        slots:
          addon: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addons/{id}/clear-operation-history'].patch
  update:
    x-apievangelist-phrasing:
      intent: Clear addon operation history via the extension
      effect: write
      questions:
      - From the addons extension, how do I clear an addon's operation history?
      - Can the extension reset an addon's status source history?
      instructions:
      - text: Via the addons extension, clear operation history of addon {addon} on instance {instance} in org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: wipe status source history for addon {addon} on org {org} instance {instance}.'
        slots:
          addon: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/addons/{id}/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh an addon via the addons extension
      effect: write
      questions:
      - From the addons extension, how do I refresh a single addon?
      - Can the extension make an addon re-read its source now?
      instructions:
      - text: Via the addons extension, refresh addon {addon} on instance {instance} in org {org}.
        slots:
          addon: path.id
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: trigger a refresh of addon {addon} for org {org} instance {instance}.'
        slots:
          addon: path.id
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/orgs/{organization_id}/argocd/instances/{instance_id}/list-addon-marketplace-installs'].post
  update:
    x-apievangelist-phrasing:
      intent: List marketplace installs via the extension
      effect: read
      questions:
      - From the addons extension, which marketplace addons are installed?
      - Can the extension filter marketplace installs and page them?
      instructions:
      - text: Using the addons extension, list marketplace installs on instance {instance} in org {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension: show marketplace installs matching {filter} for org {org} instance {instance}.'
        slots:
          filter: requestBody.filter
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/stream/orgs/{organization_id}/argocd/instances/{instance_id}/addon-marketplace-installs'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream marketplace installs via the extension
      effect: read
      questions:
      - Can the addons extension stream marketplace install changes live?
      - Is there an extension feed that follows marketplace installs in real time?
      instructions:
      - text: Using the addons extension, watch marketplace installs on instance {instance} in org {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension stream: follow marketplace install events of org {org} instance {instance}.'
        slots:
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/stream/orgs/{organization_id}/argocd/instances/{instance_id}/addon-repos'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream addon repo changes via the extension
      effect: read
      questions:
      - Can the addons extension stream live changes to addon repositories?
      - How does the extension follow one addon repo in real time?
      instructions:
      - text: Using the addons extension, watch addon repos on instance {instance} in org {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension stream: follow addon repository {repo} on org {org} instance {instance}.'
        slots:
          repo: query.addonRepoId
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/addons/stream/orgs/{organization_id}/argocd/instances/{instance_id}/addons'].get
  update:
    x-apievangelist-phrasing:
      intent: Stream addon changes via the addons extension
      effect: read
      questions:
      - Can the addons extension stream addon status changes live?
      - How do I follow one addon in real time from the extension?
      instructions:
      - text: Using the addons extension, watch addons on instance {instance} in org {org}.
        slots:
          instance: path.instance_id
          org: path.organization_id
      - text: 'Extension stream: track status changes of installed addon {addon} on org {org} instance {instance}.'
        slots:
          addon: query.addonId
          org: path.organization_id
          instance: path.instance_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/argocd/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: List instances via the KubeVision extension
      effect: read
      questions:
      - From the KubeVision extension, which Argo CD instances can I see?
      - Can KubeVision list instances for one workspace only?
      instructions:
      - text: Using KubeVision, list the Argo CD instances of organization {org}.
        slots:
          org: path.organization_id
      - text: 'KubeVision: show instances of org {org} in workspace {ws_filter}.'
        slots:
          org: path.organization_id
          ws_filter: query.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/argocd/instances/sync-operations-events'].post
  update:
    x-apievangelist-phrasing:
      intent: Query sync events via KubeVision
      effect: read
      questions:
      - From the KubeVision extension, how do I browse sync operation events?
      - Can KubeVision page sync events with limit and offset?
      instructions:
      - text: Using KubeVision, fetch sync operation events for organization {org}.
        slots:
          org: path.organization_id
      - text: 'KubeVision: pull {limit} sync events from offset {offset} for org {org}.'
        slots:
          limit: requestBody.limit
          offset: requestBody.offset
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/argocd/instances/sync-operations-stats'].post
  update:
    x-apievangelist-phrasing:
      intent: Get sync statistics via KubeVision
      effect: read
      questions:
      - From KubeVision, how do I chart sync operation stats over time?
      - Can KubeVision group sync stats by a label field?
      instructions:
      - text: Using KubeVision, get sync operation stats for organization {org}.
        slots:
          org: path.organization_id
      - text: 'KubeVision: aggregate sync stats for org {org} grouped by label {label} per {interval}.'
        slots:
          org: path.organization_id
          label: requestBody.groupByLabelField
          interval: requestBody.interval
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/argocd/instances/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an instance via KubeVision
      effect: read
      questions:
      - From the KubeVision extension, how do I read one instance's details?
      - Can KubeVision fetch an instance by name?
      instructions:
      - text: Using KubeVision, get instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: 'KubeVision: look up instance {instance} of org {org} by {id_type}.'
        slots:
          instance: path.id
          org: path.organization_id
          id_type: query.idType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/argocd/instances/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an instance via KubeVision
      effect: write
      questions:
      - Can I patch an instance's settings from the KubeVision extension?
      - How does KubeVision apply a partial instance update?
      instructions:
      - text: Using KubeVision, patch instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: 'KubeVision: apply a partial change to instance {instance} of org {org}.'
        slots:
          instance: path.id
          org: path.organization_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ext-api/v1/argocd/extensions/kubevision/orgs/{organization_id}/argocd/instances/{id}/notifications'].get
  update:
    x-apievangelist-phrasing:
      intent: Get notification settings via KubeVision
      effect: read
      questions:
      - From KubeVision, how do I see an instance's notification settings?
      - Can the KubeVision extension read notification config?
      instructions:
      - text: Using KubeVision, get notification settings of instance {instance} in organization {org}.
        slots:
          instance: path.id
          org: path.organization_id
      - text: 'KubeVision: show the notifications setup of org {org} instance {instance}.'
        slots:
          org: path.organization_id
          instance: path.id
      method: generated
      generated: '2026-09-26'