# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Account Management Applications API
  version: 1.0.0
extends: openapi/acronis-applications-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: 7
- target: $.paths['/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List all registered applications
      effect: read
      questions:
      - Which applications are registered on the platform?
      - Can I get the full catalog of cloud applications like backup and file sync?
      instructions:
      - text: List all registered applications.
      - text: Show every application on the platform.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{application_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application's details
      effect: read
      questions:
      - How do I look up one application by its ID?
      - What details are stored for a registered application?
      instructions:
      - text: Show application {application_id}.
        slots:
          application_id: path.application_id
      - text: Get details of application {application_id}.
        slots:
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{application_id}/bindings/tenants/{tenant_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable an application for a tenant
      effect: write
      questions:
      - How do I switch on an application for one of my customer tenants?
      - Can I enable a single service for a tenant?
      instructions:
      - text: Turn on application {application_id} for tenant {tenant_id}.
        slots:
          application_id: path.application_id
          tenant_id: path.tenant_id
      - text: Enable {application_id} on tenant {tenant_id}.
        slots:
          application_id: path.application_id
          tenant_id: path.tenant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{application_id}/bindings/tenants/{tenant_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable an application for a tenant
      effect: destructive
      questions:
      - How do I turn off an application for a tenant?
      - Can I remove a service from a customer without deleting the tenant?
      instructions:
      - text: Turn off application {application_id} for tenant {tenant_id}.
        slots:
          application_id: path.application_id
          tenant_id: path.tenant_id
      - text: Disable {application_id} on tenant {tenant_id}.
        slots:
          application_id: path.application_id
          tenant_id: path.tenant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{application_id}/settings/tenants/{tenant_id}/{setting_name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read an application setting for a tenant
      effect: read
      questions:
      - What value does a tenant have for a particular application setting?
      - Can I see whether an application setting is locked for a tenant?
      instructions:
      - text: Get setting {setting_name} of application {application_id} for tenant {tenant_id}.
        slots:
          setting_name: path.setting_name
          application_id: path.application_id
          tenant_id: path.tenant_id
      - text: Show tenant {tenant_id}'s {setting_name} value in app {application_id}.
        slots:
          tenant_id: path.tenant_id
          setting_name: path.setting_name
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{application_id}/settings/tenants/{tenant_id}/{setting_name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change an application setting for a tenant
      effect: write
      questions:
      - How do I set an application setting for a tenant and stop children overriding it?
      - Can a tenant's setting value apply only to that tenant and not be inherited?
      instructions:
      - text: Set {setting_name} to {value} for application {application_id} on tenant {tenant_id}.
        slots:
          setting_name: path.setting_name
          value: requestBody.value
          application_id: path.application_id
          tenant_id: path.tenant_id
      - text: Lock setting {setting_name} of {application_id} for tenant {tenant_id}.
        slots:
          setting_name: path.setting_name
          application_id: path.application_id
          tenant_id: path.tenant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/applications/{application_id}/settings/tenants/{tenant_id}/{setting_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Reset a tenant's application setting to inherited
      effect: destructive
      questions:
      - How do I clear a tenant's own setting so it inherits from its parent again?
      - What happens to an application setting after I delete it for a tenant?
      instructions:
      - text: Delete tenant {tenant_id}'s own {setting_name} setting for application {application_id}.
        slots:
          tenant_id: path.tenant_id
          setting_name: path.setting_name
          application_id: path.application_id
      - text: Reset {setting_name} in {application_id} to the inherited value for {tenant_id}.
        slots:
          setting_name: path.setting_name
          application_id: path.application_id
          tenant_id: path.tenant_id
      method: generated
      generated: '2026-09-26'