# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Edge Impulse Login API
  version: 1.0.0
extends: openapi/edge-impulse-login-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: 2
- target: $.paths['/api-login'].post
  update:
    x-apievangelist-phrasing:
      intent: Sign in and get an API token
      effect: write
      questions:
      - How do I get a JWT token to call the Edge Impulse API?
      - Can I sign in with a username and password and pass a TOTP code for two-factor?
      - What do I send to exchange my credentials for an access token?
      instructions:
      - text: Log in as {username} with password {password} and return the JWT token.
        slots:
          username: requestBody.username
          password: requestBody.password
      - text: Sign in as {username} using password {password} and two-factor code {totpToken}.
        slots:
          username: requestBody.username
          password: requestBody.password
          totpToken: requestBody.totpToken
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api-sso/{usernameOrEmail}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up single sign-on providers for a user
      effect: read
      questions:
      - Which identity providers can a given user or email domain sign in with?
      - Is SSO enabled for my company's email domain before I try to log in?
      instructions:
      - text: Show the SSO identity providers enabled for {usernameOrEmail}.
        slots:
          usernameOrEmail: path.usernameOrEmail
      - text: Check whether the email domain of {usernameOrEmail} must sign in through single sign-on.
        slots:
          usernameOrEmail: path.usernameOrEmail
      method: generated
      generated: '2026-10-01'