# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Unity Cloud Code Scripts API
  version: 1.0.0
extends: openapi/unity-scripts-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: 5
- target: $.paths['/v1/projects/{projectId}/scripts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Cloud Code scripts
      effect: read
      questions:
      - Which Cloud Code JavaScript scripts exist in my project?
      - Can I page through the scripts in a project?
      instructions:
      - text: List the Cloud Code scripts in project {projectId}.
        slots:
          projectId: path.projectId
      - text: Show {limit} Cloud Code scripts in project {projectId} after {after}.
        slots:
          limit: query.limit
          projectId: path.projectId
          after: query.after
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/projects/{projectId}/scripts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Cloud Code script
      effect: write
      questions:
      - How do I add a new server-side JavaScript script to Cloud Code?
      - Can I declare parameters when I create a Cloud Code script?
      instructions:
      - text: Create Cloud Code script {name} in {language} with code {code} in project {projectId}.
        slots:
          name: requestBody.name
          language: requestBody.language
          code: requestBody.code
          projectId: path.projectId
      - text: Add a new script {name} ({language}) to project {projectId} using code {code} and params {params}.
        slots:
          name: requestBody.name
          language: requestBody.language
          projectId: path.projectId
          code: requestBody.code
          params: requestBody.params
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/projects/{projectId}/scripts/{scriptName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Cloud Code script and its latest code
      effect: read
      questions:
      - What does the latest version of a Cloud Code script look like?
      - Can I read the source of an existing script?
      instructions:
      - text: Show Cloud Code script {scriptName} in project {projectId}.
        slots:
          scriptName: path.scriptName
          projectId: path.projectId
      - text: Get the latest code for script {scriptName} in project {projectId}.
        slots:
          scriptName: path.scriptName
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/projects/{projectId}/scripts/{scriptName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Cloud Code script's code
      effect: write
      questions:
      - Can I push new code to an existing Cloud Code script?
      - Is it possible to change a script's parameters without recreating it?
      instructions:
      - text: Update script {scriptName} in project {projectId} with code {code}.
        slots:
          scriptName: path.scriptName
          projectId: path.projectId
          code: requestBody.code
      - text: Change the params of Cloud Code script {scriptName} in project {projectId} to {params}.
        slots:
          scriptName: path.scriptName
          projectId: path.projectId
          params: requestBody.params
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/projects/{projectId}/scripts/{scriptName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Cloud Code script
      effect: destructive
      questions:
      - Does deleting a Cloud Code script remove all its versions?
      - Can I get rid of a script I no longer call?
      instructions:
      - text: Delete Cloud Code script {scriptName} from project {projectId}.
        slots:
          scriptName: path.scriptName
          projectId: path.projectId
      - text: Remove script {scriptName} and all its versions in project {projectId}.
        slots:
          scriptName: path.scriptName
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'