# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Console Param Store API
  version: 1.0.0
extends: openapi/statsig-param-store-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['/console/v1/param_stores'].get
  update:
    x-apievangelist-phrasing:
      intent: List parameter stores
      effect: read
      questions:
      - Which parameter stores exist in my project?
      - Can I page through param stores?
      instructions:
      - text: List all param stores.
      - text: Show param stores page {page}, {limit} per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/param_stores'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a parameter store
      effect: write
      questions:
      - How do I set up a new parameter store?
      - Can I assign a param store to target apps when creating it?
      instructions:
      - text: Create param store {name} with display name {displayName} and description {description}.
        slots:
          name: requestBody.name
          displayName: requestBody.displayName
          description: requestBody.description
      - text: Create param store {name} ({displayName}, {description}) for target apps {targetAppIDs}.
        slots:
          name: requestBody.name
          displayName: requestBody.displayName
          description: requestBody.description
          targetAppIDs: requestBody.targetAppIDs
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/param_stores/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a parameter store
      effect: read
      questions:
      - What parameters are defined in a given param store?
      - Can I read one parameter store by its name?
      instructions:
      - text: Show param store {name}.
        slots:
          name: path.name
      - text: Get the parameters in param store {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/param_stores/{name}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a parameter store's parameters
      effect: write
      questions:
      - How do I change the parameters inside a param store?
      - Can I update a param store's description?
      instructions:
      - text: Set the parameters of param store {name} to {parameters}.
        slots:
          name: path.name
          parameters: requestBody.parameters
      - text: Change param store {name}'s description to {description}.
        slots:
          name: path.name
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/param_stores/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a parameter store
      effect: destructive
      questions:
      - Can I remove a param store we no longer use?
      - Is deleting a parameter store reversible?
      instructions:
      - text: Delete param store {name}.
        slots:
          name: path.name
      - text: Remove the parameter store called {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'