# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Data migration API
  version: 1.0.0
extends: openapi/nylas-data-migration-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 1
- target: $.paths['/v3/migration-tools/translate'].post
  update:
    x-apievangelist-phrasing:
      intent: Translate v2 IDs into v3 provider IDs
      effect: read
      questions:
      - How do I map my old v2 object IDs to v3 provider IDs during a migration?
      - Is there a limit on how many IDs are translated in one request?
      - Does the ID translation work for v2 accounts on Outlook?
      instructions:
      - text: Translate {resource_type} IDs for v2 account {v2_account_id} to v3 provider IDs.
        slots:
          resource_type: requestBody.resource_type
          v2_account_id: requestBody.v2_account_id
      - text: Convert v2 IDs {nylas_ids} of type {resource_type} on account {v2_account_id}.
        slots:
          nylas_ids: requestBody.nylas_ids
          resource_type: requestBody.resource_type
          v2_account_id: requestBody.v2_account_id
      method: generated
      generated: '2026-09-26'