# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Meltwater Account Management API
  version: 1.0.0
extends: openapi/meltwater-account-management-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: 5
- target: $.paths['/v3/accounts/me/companies'].get
  update:
    x-apievangelist-phrasing:
      intent: List the companies on my account
      effect: read
      questions:
      - Which companies does my Meltwater account belong to?
      - How do I find the company ID to pass as company_id on other calls?
      instructions:
      - text: List all the companies my account has access to.
      - text: Show me my company IDs so I can target the right company.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/accounts/me/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List the workspaces on my account
      effect: read
      questions:
      - What workspaces do I have set up?
      - Can I see every workspace my user is part of?
      instructions:
      - text: List all my workspaces.
      - text: Show the workspaces available to my account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/accounts/me/tokens'].get
  update:
    x-apievangelist-phrasing:
      intent: List my API tokens
      effect: read
      questions:
      - Which API tokens have been issued on my account?
      - How can I audit the API tokens I've created?
      instructions:
      - text: List all my API tokens.
      - text: Show every API token tied to my account for an access review.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/usage/me/metrics/{metric}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check usage of a feature metric
      effect: read
      questions:
      - How many documents have I exported through the API this period?
      - What is my streaming document count usage so far?
      - Can I see feature usage for just one of my API tokens?
      instructions:
      - text: Show my {metric} usage for the {feature} feature.
        slots:
          metric: path.metric
          feature: query.feature
      - text: Get {metric} usage for feature {feature} over period {period} for token {token_id}.
        slots:
          metric: path.metric
          feature: query.feature
          period: query.period
          token_id: query.token_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/usage/me/requests'].get
  update:
    x-apievangelist-phrasing:
      intent: See how many API calls I have made
      effect: read
      questions:
      - How many API requests have I made this month?
      - Which of my API tokens is responsible for most of my call volume?
      instructions:
      - text: Show my API call count for period {period}.
        slots:
          period: query.period
      - text: Get the API request statistics for token {token_id}.
        slots:
          token_id: query.token_id
      method: generated
      generated: '2026-10-01'