# 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 Custom Data API
  version: 1.0.0
extends: openapi/unity-custom-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: 2
- target: $.paths['/v1/data/projects/{projectId}/players/{playerId}/protected-items'].post
  update:
    x-apievangelist-phrasing:
      intent: Save server-only protected player data
      effect: write
      questions:
      - Can I store player data that only the server can write but the player can read?
      - Where do I save values a player must not be able to tamper with?
      instructions:
      - text: Save protected data {data} for player {playerId} in project {projectId}.
        slots:
          data: requestBody.data
          playerId: path.playerId
          projectId: path.projectId
      - text: Write server-only items {data} to player {playerId}'s protected storage 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}/public-items'].post
  update:
    x-apievangelist-phrasing:
      intent: Save public player data visible to everyone
      effect: write
      questions:
      - Can I store player data that every other player can see?
      - Where should I save a player's public profile info like a display badge?
      instructions:
      - text: Save public data {data} for player {playerId} in project {projectId}.
        slots:
          data: requestBody.data
          playerId: path.playerId
          projectId: path.projectId
      - text: Publish items {data} on player {playerId}'s public profile in project {projectId}.
        slots:
          data: requestBody.data
          playerId: path.playerId
          projectId: path.projectId
      method: generated
      generated: '2026-10-01'