# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Method Teams API
  version: 1.0.0
extends: openapi/methodfi-teams-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: 7
- target: $.paths['/teams'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current team
      effect: read
      questions:
      - Which team is my API key tied to?
      - Can I see my own team's details?
      instructions:
      - text: Get my current team on API version {version}.
        slots:
          version: header.Method-Version
      - text: Show the team that owns this API key.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/teams'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a child team
      effect: write
      questions:
      - How do I create a sub-team under my team?
      - Can I set up child teams for different business units?
      instructions:
      - text: Create a child team named {name}.
        slots:
          name: requestBody.name
      - text: Add a sub-team called {name} under my team.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/teams/default_encryption_key'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the team's default encryption key
      effect: write
      questions:
      - How do I set the key used to encrypt sensitive data in responses?
      - Can I change my team's default encryption key?
      instructions:
      - text: Set my team's default encryption key to {key}.
        slots:
          key: requestBody.key
      - text: Use {key} as the default key for encrypting sensitive response data.
        slots:
          key: requestBody.key
      method: generated
      generated: '2026-10-01'
- target: $.paths['/teams/mle/public_keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List the team's MLE public keys
      effect: read
      questions:
      - Which message-level encryption keys has my team registered?
      - Can I see all MLE public keys on my team?
      instructions:
      - text: List my team's MLE public keys on API version {version}.
        slots:
          version: header.Method-Version
      - text: Show every registered MLE public key.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/teams/mle/public_keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Register an MLE public key
      effect: write
      questions:
      - How do I register my public key for message-level encryption?
      - Can I add another MLE public key to my team?
      instructions:
      - text: Register MLE public key {jwk} for my team.
        slots:
          jwk: requestBody.jwk
      - text: Add JWK {jwk} as a team message-level encryption key.
        slots:
          jwk: requestBody.jwk
      method: generated
      generated: '2026-10-01'
- target: $.paths['/teams/mle/public_keys/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one MLE public key
      effect: read
      questions:
      - Can I look up one of my registered MLE keys by its ID?
      - What are the details of a specific team MLE key?
      instructions:
      - text: Get MLE public key {key}.
        slots:
          key: path.id
      - text: Show the details of team MLE key {key}.
        slots:
          key: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/teams/mle/public_keys/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an MLE public key
      effect: destructive
      questions:
      - How do I remove an MLE public key from my team?
      - Is deleting a team MLE key reversible?
      instructions:
      - text: Delete MLE public key {key}.
        slots:
          key: path.id
      - text: Permanently remove team MLE key {key}.
        slots:
          key: path.id
      method: generated
      generated: '2026-10-01'