# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Launch Companies API
  version: 1.0.0
extends: openapi/adobe-launch-companies-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: 7
- target: $.paths['/companies'].get
  update:
    x-apievangelist-phrasing:
      intent: List the companies I can access
      effect: read
      questions:
      - Which companies does my tags account have access to?
      - Can I find a company by its IMS org ID?
      instructions:
      - text: List the companies I have access to.
      - text: Find the company for org {org_id}.
        slots:
          org_id: query.org_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{COMPANY_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a company's tag details
      effect: read
      questions:
      - How can I view one company's details by its ID in the tags API?
      - What org ID is a given tags company linked to?
      instructions:
      - text: Retrieve tags company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
      - text: Show the org and name of tags company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{COMPANY_ID}/properties'].get
  update:
    x-apievangelist-phrasing:
      intent: List a company's properties
      effect: read
      questions:
      - What properties sit under my company?
      - Can I list only a company's enabled properties for one platform?
      instructions:
      - text: List the properties under company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
      - text: Show company {COMPANY_ID}'s properties on platform {platform}.
        slots:
          COMPANY_ID: path.COMPANY_ID
          platform: query.platform
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{COMPANY_ID}/properties'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a property under a company
      effect: write
      questions:
      - How do I add a new web or mobile property to my company?
      - What settings are needed to create a property?
      instructions:
      - text: Create a property under company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
      - text: Add a property to company {COMPANY_ID} with {data}.
        slots:
          COMPANY_ID: path.COMPANY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{COMPANY_ID}/app_configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a company's app configurations
      effect: read
      questions:
      - Which mobile app configurations are set up for my company?
      - Can I filter app configurations by messaging service or platform?
      instructions:
      - text: List the app configurations for company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
      - text: Show app configurations using messaging service {messaging_service} for company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
          messaging_service: query.messaging_service
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{COMPANY_ID}/app_configurations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an app configuration for a company
      effect: write
      questions:
      - How do I register a mobile app's push messaging credentials for my company?
      - Can I add a new app configuration through the API?
      instructions:
      - text: Create an app configuration for company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
      - text: 'Add this app configuration to company {COMPANY_ID}: {data}.'
        slots:
          COMPANY_ID: path.COMPANY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{companyId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a company by ID
      effect: read
      questions:
      - How do I get a company's details using its companyId?
      - What does the company record for my organization contain?
      instructions:
      - text: Look up company {companyId}.
        slots:
          companyId: path.companyId
      - text: Get the full company record for {companyId}.
        slots:
          companyId: path.companyId
      method: generated
      generated: '2026-09-26'