# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Unity Player Authentication Identity Providers API
  version: 1.0.0
extends: openapi/unity-identity-providers-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/authentication/external-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Sign in with an external identity provider token
      effect: write
      questions:
      - Can a player log in using an identity token from Google, Apple, Steam or Facebook?
      - Is there an option to refuse creating a new account when signing in with a provider token?
      instructions:
      - text: Sign in the player with {idProvider} identity token {token}.
        slots:
          idProvider: requestBody.idProvider
          token: requestBody.token
      - text: Log in via {idProvider} with token {token}, sign-in only {signInOnly}.
        slots:
          idProvider: requestBody.idProvider
          token: requestBody.token
          signInOnly: requestBody.signInOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/players/{playerId}/link/external-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Link an external identity to a player
      effect: write
      questions:
      - Can an existing player attach their Apple or Google login to their account?
      - How do I connect a third-party login to a player who started as a guest?
      instructions:
      - text: Link {idProvider} token {token} to player {playerId}.
        slots:
          idProvider: requestBody.idProvider
          token: requestBody.token
          playerId: path.playerId
      - text: Attach the {idProvider} identity from token {token} to account {playerId}.
        slots:
          idProvider: requestBody.idProvider
          token: requestBody.token
          playerId: path.playerId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/players/{playerId}/unlink/external-token'].post
  update:
    x-apievangelist-phrasing:
      intent: Unlink an external identity from a player
      effect: destructive
      questions:
      - Can I disconnect a linked login provider from a player account?
      - What happens when a player removes their linked Steam login?
      instructions:
      - text: Unlink {idProvider} from player {playerId}.
        slots:
          idProvider: requestBody.idProvider
          playerId: path.playerId
      - text: Remove the linked {idProvider} identity from account {playerId}.
        slots:
          idProvider: requestBody.idProvider
          playerId: path.playerId
      method: generated
      generated: '2026-10-01'