# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect App Encryption Declarations API
  version: 1.0.0
extends: openapi/ios-appencryptiondeclarations-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: 8
- target: $.paths['/v1/appEncryptionDeclarations'].get
  update:
    x-apievangelist-phrasing:
      intent: List export compliance encryption declarations
      effect: read
      questions:
      - How do I list the export compliance encryption declarations for my app?
      - Can I filter encryption declarations by app, platform or build?
      instructions:
      - text: List the encryption declarations for app {app}.
        slots:
          app: query.filter[app]
      - text: Show encryption declarations on platform {platform}.
        slots:
          platform: query.filter[platform]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEncryptionDeclarations'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit an export compliance encryption declaration
      effect: write
      questions:
      - How do I submit an export compliance encryption declaration?
      - What do I send to declare my app's use of encryption?
      instructions:
      - text: Create an encryption declaration with {data}.
        slots:
          data: requestBody.data
      - text: 'Submit this export compliance declaration: {data}.'
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEncryptionDeclarations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an encryption declaration
      effect: read
      questions:
      - Can I look up one encryption declaration by ID?
      - What's the state of a specific export compliance declaration?
      instructions:
      - text: Get encryption declaration {id}.
        slots:
          id: path.id
      - text: Show the details of export compliance declaration {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEncryptionDeclarations/{id}/relationships/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app ID of an encryption declaration
      effect: read
      questions:
      - Which app ID is an encryption declaration attached to?
      - Can I get only the app reference of an export compliance declaration?
      instructions:
      - text: Give me only the app ID for encryption declaration {id}.
        slots:
          id: path.id
      - text: Return the app linkage of export compliance declaration {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEncryptionDeclarations/{id}/app'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the app an encryption declaration covers
      effect: read
      questions:
      - Which app does this encryption declaration belong to?
      - Where do I see the full app details behind an export compliance declaration?
      instructions:
      - text: Show the app for encryption declaration {id}.
        slots:
          id: path.id
      - text: Fetch the full app record behind export compliance declaration {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEncryptionDeclarations/{id}/relationships/appEncryptionDeclarationDocument'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the document ID of an encryption declaration
      effect: read
      questions:
      - What's the document ID attached to my encryption declaration?
      - Can I get only the declaration document reference?
      instructions:
      - text: Give me only the document ID for encryption declaration {id}.
        slots:
          id: path.id
      - text: Return the document linkage of export compliance declaration {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEncryptionDeclarations/{id}/appEncryptionDeclarationDocument'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an encryption declaration's document
      effect: read
      questions:
      - How do I see the uploaded document for an encryption declaration?
      - What are the details of the export compliance document I attached?
      instructions:
      - text: Show the declaration document for encryption declaration {id}.
        slots:
          id: path.id
      - text: Fetch the full uploaded document record of export compliance declaration {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEncryptionDeclarations/{id}/relationships/builds'].post
  update:
    x-apievangelist-phrasing:
      intent: Attach builds to an encryption declaration
      effect: write
      questions:
      - How do I attach builds to an existing encryption declaration?
      - Can one export compliance declaration cover several builds?
      instructions:
      - text: Attach builds {data} to encryption declaration {id}.
        slots:
          data: requestBody.data
          id: path.id
      - text: 'Link these builds to export compliance declaration {id}: {data}.'
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'