# 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 Save Player Data API
  version: 1.0.0
extends: openapi/unity-player-data-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: 3
- target: $.paths['/v1/data/projects/{projectId}/players/{playerId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a player's saved data items
      effect: read
      questions:
      - What save data is stored for a player in Cloud Save?
      - Can I fetch only certain keys of a player's data?
      instructions:
      - text: Show all saved data for player {playerId} in project {projectId}.
        slots:
          playerId: path.playerId
          projectId: path.projectId
      - text: Get keys {keys} of player {playerId}'s data in project {projectId}.
        slots:
          keys: query.keys
          playerId: path.playerId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/data/projects/{projectId}/players/{playerId}/items'].post
  update:
    x-apievangelist-phrasing:
      intent: Save key-value data items for a player
      effect: write
      questions:
      - How do I save a player's progress as key-value items?
      - Does saving player data support write locks to avoid overwriting newer values?
      instructions:
      - text: Save data {data} for player {playerId} in project {projectId}.
        slots:
          data: requestBody.data
          playerId: path.playerId
          projectId: path.projectId
      - text: Write items {data} to player {playerId}'s Cloud Save in project {projectId}.
        slots:
          data: requestBody.data
          playerId: path.playerId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/data/projects/{projectId}/players/{playerId}/items/{key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one of a player's data items
      effect: destructive
      questions:
      - Can I remove a single saved key for a player?
      - What do I call to delete one Cloud Save item by key?
      instructions:
      - text: Delete key {key} from player {playerId}'s data in project {projectId}.
        slots:
          key: path.key
          playerId: path.playerId
          projectId: path.projectId
      - text: Remove saved item {key} for player {playerId} in project {projectId}.
        slots:
          key: path.key
          playerId: path.playerId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'