# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Forge Servers API
  version: 1.0.0
extends: openapi/laravel-servers-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 46
- target: $.paths['/orgs/{organization}/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's Forge servers
      effect: read
      questions:
      - Which servers does my Forge organization have running?
      - Can I filter my server list by region, PHP version or database type?
      instructions:
      - text: List all servers in organization {organization}.
        slots:
          organization: path.organization
      - text: Find servers in {organization} running PHP {php_version} in region {region}.
        slots:
          organization: path.organization
          php_version: query.filter[php_version]
          region: query.filter[region]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers'].post
  update:
    x-apievangelist-phrasing:
      intent: Provision a new server
      effect: write
      questions:
      - How do I provision a new server through Laravel Forge?
      - Can I create a server on my own custom VPS instead of a cloud provider?
      instructions:
      - text: Create a server named {name} on {provider} running Ubuntu {ubuntu_version} in organization {organization}.
        slots:
          name: requestBody.name
          provider: requestBody.provider
          ubuntu_version: requestBody.ubuntu_version
          organization: path.organization
      - text: Provision a {type} server called {name} on {provider} with Ubuntu {ubuntu_version} and PHP {php_version} in {organization}.
        slots:
          type: requestBody.type
          name: requestBody.name
          provider: requestBody.provider
          ubuntu_version: requestBody.ubuntu_version
          php_version: requestBody.php_version
          organization: path.organization
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/archives'].get
  update:
    x-apievangelist-phrasing:
      intent: List archived servers
      effect: read
      questions:
      - Which of my servers have been archived?
      - Where can I see servers I archived but did not delete?
      instructions:
      - text: List the archived servers in organization {organization}.
        slots:
          organization: path.organization
      - text: Show me everything archived in {organization}, sorted by {sort}.
        slots:
          organization: path.organization
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/archives'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive a server
      effect: write
      questions:
      - Can I archive a server instead of deleting it?
      - What happens to a server when I archive it in Forge?
      instructions:
      - text: Archive server {server_id} in organization {organization}.
        slots:
          server_id: requestBody.server_id
          organization: path.organization
      - text: Move server {server_id} into the archive.
        slots:
          server_id: requestBody.server_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/archives/{server}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unarchive a server
      effect: destructive
      questions:
      - How do I bring an archived server back into use?
      - Do I need to regenerate the server key before unarchiving a server?
      instructions:
      - text: Unarchive server {server} in organization {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Restore archived server {server} back to my active servers.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/background-processes/{backgroundProcess}/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart, stop or start a server background process
      effect: write
      questions:
      - How do I restart a daemon running at the server level?
      - Can I stop a background process on a server without deleting it?
      instructions:
      - text: Restart background process {backgroundProcess} on server {server} in {organization}.
        slots:
          backgroundProcess: path.backgroundProcess
          server: path.server
          organization: path.organization
      - text: Run the {action} action on background process {backgroundProcess} of server {server}.
        slots:
          action: requestBody.action
          backgroundProcess: path.backgroundProcess
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Reboot or power-cycle a server
      effect: write
      questions:
      - How do I reboot a whole server from the API?
      - Can I power-cycle a server that has stopped responding?
      instructions:
      - text: Reboot server {server} in organization {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Run the {action} action on server {server}.
        slots:
          action: requestBody.action
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/services/nginx/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Reboot or stop Nginx on a server
      effect: write
      questions:
      - How do I restart Nginx on one of my servers?
      - Can I stop the Nginx service on a server?
      instructions:
      - text: Reboot Nginx on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Run the {action} action on the Nginx service of server {server}.
        slots:
          action: requestBody.action
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/services/postgres/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Reboot or stop Postgres on a server
      effect: write
      questions:
      - How do I restart PostgreSQL on a Forge server?
      - Can I stop the Postgres service running on my server?
      instructions:
      - text: Reboot Postgres on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Run the {action} action on the Postgres service of server {server}.
        slots:
          action: requestBody.action
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/services/redis/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Reboot Redis on a server
      effect: write
      questions:
      - How do I restart the Redis service on a server?
      - Is there a way to reboot Redis without rebooting the whole machine?
      instructions:
      - text: Reboot Redis on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Run the {action} action on the Redis service of server {server}.
        slots:
          action: requestBody.action
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/services/mysql/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Reboot or stop MySQL on a server
      effect: write
      questions:
      - How do I restart MySQL on my Forge server?
      - Can I stop the MySQL service on a server?
      instructions:
      - text: Reboot MySQL on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Run the {action} action on the MySQL service of server {server}.
        slots:
          action: requestBody.action
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/services/php/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart or reload PHP-FPM for a PHP version
      effect: write
      questions:
      - How do I gracefully reload PHP-FPM for one PHP version?
      - Can I reboot PHP-FPM for PHP 8.3 only, leaving other versions alone?
      instructions:
      - text: Reload PHP-FPM {version} on server {server} in {organization}.
        slots:
          version: requestBody.version
          server: path.server
          organization: path.organization
      - text: Run the {action} action on PHP-FPM {version} on server {server}.
        slots:
          action: requestBody.action
          version: requestBody.version
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/services/supervisor/actions'].post
  update:
    x-apievangelist-phrasing:
      intent: Reboot Supervisor on a server
      effect: write
      questions:
      - How do I restart the Supervisor service that runs my queue workers?
      - Can I reboot Supervisor on a server through the API?
      instructions:
      - text: Reboot Supervisor on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Run the {action} action on the Supervisor service of server {server}.
        slots:
          action: requestBody.action
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a server's details
      effect: read
      questions:
      - What are the details of a specific server in my organization?
      - Where can I see one server's provider, size and IP address?
      instructions:
      - text: Show server {server} in organization {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Get the details of server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a server or change its IP, timezone or tags
      effect: write
      questions:
      - How do I rename a server or change its tags?
      - Can I update the IP address or timezone Forge has on record for a server?
      instructions:
      - text: Rename server {server} in {organization} to {name}.
        slots:
          server: path.server
          organization: path.organization
          name: requestBody.name
      - text: Set the timezone of server {server} to {timezone}.
        slots:
          server: path.server
          timezone: requestBody.timezone
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a server
      effect: destructive
      questions:
      - How do I delete a server I no longer need?
      - Can I remove a server from Forge but keep it running at the cloud provider?
      instructions:
      - text: Delete server {server} from organization {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: 'Remove server {server} from Forge only, preserve at provider: {preserve_at_provider}.'
        slots:
          server: path.server
          preserve_at_provider: query.preserve_at_provider
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/network'].get
  update:
    x-apievangelist-phrasing:
      intent: See which servers share a server's network
      effect: read
      questions:
      - Which servers are in the same network as this server?
      - How can I check a server's private network peers?
      instructions:
      - text: Show the network of server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: List the servers networked with server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/network'].put
  update:
    x-apievangelist-phrasing:
      intent: Set which servers a server can network with
      effect: write
      questions:
      - How do I let two of my servers talk to each other over the network?
      - Can I replace a server's network with a new list of servers?
      instructions:
      - text: Sync the network of server {server} in {organization} to servers {servers}.
        slots:
          server: path.server
          organization: path.organization
          servers: requestBody.servers
      - text: Connect server {server} to servers {servers} on its network.
        slots:
          server: path.server
          servers: requestBody.servers
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List a server's event history
      effect: read
      questions:
      - What has happened on this server recently?
      - Can I see which server events were started by a particular user?
      instructions:
      - text: List events for server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Show events on server {server} initiated by {initiated_by}.
        slots:
          server: path.server
          initiated_by: query.filter[initiated_by]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/events/{event}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one server event
      effect: read
      questions:
      - What are the details of a single event on my server?
      - Who ran a specific server event and when?
      instructions:
      - text: Show event {event} on server {server} in {organization}.
        slots:
          event: path.event
          server: path.server
          organization: path.organization
      - text: Get server event {event} for server {server}.
        slots:
          event: path.event
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/events/{event}/output'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the output of a server event
      effect: read
      questions:
      - Where can I read the console output from a server event?
      - How do I see why a provisioning step on my server failed?
      instructions:
      - text: Show the output of event {event} on server {server} in {organization}.
        slots:
          event: path.event
          server: path.server
          organization: path.organization
      - text: Fetch the log output for server event {event} on {server}.
        slots:
          event: path.event
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/cli-version'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a server's default PHP CLI version
      effect: read
      questions:
      - Which PHP version runs when I type php on the command line of my server?
      - What is the CLI default PHP version on a server?
      instructions:
      - text: Show the PHP CLI version on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Tell me which PHP version the CLI uses on server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/cli-version'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a server's default PHP CLI version
      effect: write
      questions:
      - How do I switch the command-line PHP version on a server?
      - Can the CLI use a different PHP version than my sites?
      instructions:
      - text: Set the PHP CLI version on server {server} in {organization} to {php_version}.
        slots:
          server: path.server
          organization: path.organization
          php_version: requestBody.php_version
      - text: Make PHP {php_version} the command-line default on server {server}.
        slots:
          php_version: requestBody.php_version
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/site-version'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a server's default PHP version for sites
      effect: read
      questions:
      - Which PHP version do new sites on my server use by default?
      - What is the site default PHP version on a server?
      instructions:
      - text: Show the default site PHP version on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Tell me which PHP version new sites get on server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/site-version'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a server's default PHP version for sites
      effect: write
      questions:
      - How do I change the default PHP version for sites on a server?
      - Can I make new sites on a server use PHP 8.4 by default?
      instructions:
      - text: Set the default site PHP version on server {server} in {organization} to {php_version}.
        slots:
          server: path.server
          organization: path.organization
          php_version: requestBody.php_version
      - text: Make PHP {php_version} the site default on server {server}.
        slots:
          php_version: requestBody.php_version
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List PHP versions installed on a server
      effect: read
      questions:
      - Which PHP versions are installed on my server?
      - Can I filter a server's PHP versions by install status?
      instructions:
      - text: List installed PHP versions on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Show PHP versions on server {server} with status {status}.
        slots:
          server: path.server
          status: query.filter[status]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions'].post
  update:
    x-apievangelist-phrasing:
      intent: Install a PHP version on a server
      effect: write
      questions:
      - How do I install an additional PHP version on a server?
      - Can I install a new PHP version and make it the CLI default at the same time?
      instructions:
      - text: Install PHP {version} on server {server} in {organization}.
        slots:
          version: requestBody.version
          server: path.server
          organization: path.organization
      - text: 'Install PHP {version} on server {server} and make it the site default: {site_default}.'
        slots:
          version: requestBody.version
          server: path.server
          site_default: requestBody.site_default
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an installed PHP version
      effect: read
      questions:
      - What is the status of a specific PHP version on my server?
      - Is a given PHP version fully installed on a server?
      instructions:
      - text: Show PHP version {phpVersion} on server {server} in {organization}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
      - text: Get the install details for PHP {phpVersion} on server {server}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}'].put
  update:
    x-apievangelist-phrasing:
      intent: Patch an installed PHP version to its latest release
      effect: write
      questions:
      - How do I upgrade an installed PHP version to the newest patch release?
      - Can I apply the latest PHP security patch on a server?
      instructions:
      - text: Update PHP {phpVersion} on server {server} in {organization} to the latest patch.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
      - text: Apply the newest patch release of PHP {phpVersion} on server {server}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Uninstall a PHP version from a server
      effect: destructive
      questions:
      - How do I uninstall an old PHP version from my server?
      - Can I remove a PHP version that no site uses anymore?
      instructions:
      - text: Uninstall PHP {phpVersion} from server {server} in {organization}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
      - text: Remove PHP {phpVersion} from server {server}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}/configs/fpm'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a PHP version's FPM config
      effect: read
      questions:
      - Where can I read the php.ini that PHP-FPM uses for a version?
      - What does the FPM configuration look like for PHP on my server?
      instructions:
      - text: Show the FPM config for PHP {phpVersion} on server {server} in {organization}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
      - text: Get the PHP-FPM ini for PHP {phpVersion} on server {server}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}/configs/fpm'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a PHP version's FPM config
      effect: write
      questions:
      - How do I change the php.ini used by PHP-FPM on a server?
      - Can I raise memory_limit for web requests only, not the CLI?
      instructions:
      - text: Replace the FPM config of PHP {phpVersion} on server {server} in {organization} with {config}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
          config: requestBody.config
      - text: Write {config} as the PHP-FPM ini for PHP {phpVersion} on {server}.
        slots:
          config: requestBody.config
          phpVersion: path.phpVersion
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}/configs/cli'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a PHP version's CLI config
      effect: read
      questions:
      - Where can I see the php.ini used by command-line PHP?
      - What settings does the CLI php.ini have for a version on my server?
      instructions:
      - text: Show the CLI config for PHP {phpVersion} on server {server} in {organization}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
      - text: Get the command-line php.ini for PHP {phpVersion} on server {server}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}/configs/cli'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a PHP version's CLI config
      effect: write
      questions:
      - How do I change the php.ini used by artisan and other CLI commands?
      - Can I edit the command-line PHP configuration for one version?
      instructions:
      - text: Replace the CLI config of PHP {phpVersion} on server {server} in {organization} with {config}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
          config: requestBody.config
      - text: Write {config} as the command-line php.ini for PHP {phpVersion} on {server}.
        slots:
          config: requestBody.config
          phpVersion: path.phpVersion
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}/configs/pool'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a PHP-FPM pool config
      effect: read
      questions:
      - Where can I see the PHP-FPM pool settings like pm.max_children?
      - Can I view the FPM pool config for a specific system user?
      instructions:
      - text: Show the worker pool settings (pm.max_children etc.) of PHP {phpVersion} on {server} in {organization}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
      - text: Get the PHP {phpVersion} pool config for user {user} on server {server}.
        slots:
          phpVersion: path.phpVersion
          user: query.user
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/versions/{phpVersion}/configs/pool'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a PHP-FPM pool config
      effect: write
      questions:
      - How do I tune PHP-FPM worker counts on my server?
      - Can I change the FPM pool config for one system user only?
      instructions:
      - text: Update the worker pool settings of PHP {phpVersion} on {server} in {organization} to {config}.
        slots:
          phpVersion: path.phpVersion
          server: path.server
          organization: path.organization
          config: requestBody.config
      - text: Write pool config {config} for user {user} on PHP {phpVersion} of server {server}.
        slots:
          config: requestBody.config
          user: requestBody.user
          phpVersion: path.phpVersion
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/max-upload-size'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a server's PHP max upload size
      effect: read
      questions:
      - What is the largest file PHP will accept as an upload on my server?
      - How big can uploads be on a server right now?
      instructions:
      - text: Show the PHP max upload size on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Tell me the upload size limit for PHP on server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/max-upload-size'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a server's PHP max upload size
      effect: write
      questions:
      - How do I let users upload larger files to my server?
      - Can I raise the PHP upload limit in megabytes?
      instructions:
      - text: Set the PHP max upload size on server {server} in {organization} to {max_upload_size}.
        slots:
          server: path.server
          organization: path.organization
          max_upload_size: requestBody.max_upload_size
      - text: Raise the upload limit on server {server} to {max_upload_size} MB.
        slots:
          server: path.server
          max_upload_size: requestBody.max_upload_size
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/max-execution-time'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a server's PHP max execution time
      effect: read
      questions:
      - How long can a PHP script run before it times out on my server?
      - What is the max_execution_time on a server?
      instructions:
      - text: Show the PHP max execution time on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Tell me the PHP script timeout on server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/max-execution-time'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a server's PHP max execution time
      effect: write
      questions:
      - How do I give long-running PHP requests more time before timing out?
      - Can I change max_execution_time across a server?
      instructions:
      - text: Set the PHP max execution time on server {server} in {organization} to {max_execution_time} seconds.
        slots:
          server: path.server
          organization: path.organization
          max_execution_time: requestBody.max_execution_time
      - text: Let PHP scripts on server {server} run for up to {max_execution_time} seconds.
        slots:
          server: path.server
          max_execution_time: requestBody.max_execution_time
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/opcache'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether OPcache is enabled on a server
      effect: read
      questions:
      - Is PHP OPcache turned on for my server?
      - What is the current OPcache status on a server?
      instructions:
      - text: Show the OPcache status of server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Check if OPcache is enabled on server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/opcache'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable PHP OPcache on a server
      effect: write
      questions:
      - How do I turn on OPcache to speed up PHP on my server?
      - Can I enable OPcache through the API?
      instructions:
      - text: Enable OPcache on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Turn on PHP OPcache for server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/servers/{server}/php/opcache'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable PHP OPcache on a server
      effect: destructive
      questions:
      - How do I turn OPcache off on a server while debugging?
      - Can I disable PHP OPcache for a server?
      instructions:
      - text: Disable OPcache on server {server} in {organization}.
        slots:
          server: path.server
          organization: path.organization
      - text: Turn off PHP OPcache for server {server}.
        slots:
          server: path.server
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/teams/{team}/servers'].get
  update:
    x-apievangelist-phrasing:
      intent: List servers shared with a team
      effect: read
      questions:
      - Which servers can a particular team access?
      - What servers have been shared with my team?
      instructions:
      - text: List servers shared with team {team} in organization {organization}.
        slots:
          team: path.team
          organization: path.organization
      - text: Show the servers team {team} has access to.
        slots:
          team: path.team
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/teams/{team}/servers'].post
  update:
    x-apievangelist-phrasing:
      intent: Share a server with a team
      effect: write
      questions:
      - How do I give a team access to one of my servers?
      - Can I share a single server with another team?
      instructions:
      - text: Share server {server_id} with team {team} in {organization}.
        slots:
          server_id: requestBody.server_id
          team: path.team
          organization: path.organization
      - text: Give team {team} access to server {server_id}.
        slots:
          team: path.team
          server_id: requestBody.server_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{organization}/teams/{team}/servers/{server}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Stop sharing a server with a team
      effect: destructive
      questions:
      - How do I revoke a team's access to a server?
      - Can I unshare a server from a team without deleting it?
      instructions:
      - text: Unshare server {server} from team {team} in {organization}.
        slots:
          server: path.server
          team: path.team
          organization: path.organization
      - text: Remove team {team}'s access to server {server}.
        slots:
          team: path.team
          server: path.server
      method: generated
      generated: '2026-10-01'