Hilt · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Hilt So Hilt PayMe Connector API

8 actions 8 updates phrasing extends openapi/hilt-so-hilt-payme-connector-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Hilt's API. It is a proposal applied on top of the contract, not a document Hilt publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 8

$.info

$.paths['/v1/connectors/grok/authorization'].get

$.paths['/v1/connectors/grok/authorization'].post

$.paths['/v1/pay-me/connector-connections'].get

$.paths['/v1/pay-me/connector-connections/{connection_id}'].delete

$.paths['/v1/pay-me/payment-requests'].post

$.paths['/v1/pay-me/payment-requests/{public_id}'].get

$.paths['/v1/pay-me/payment-intents/{public_id}'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hilt So Hilt PayMe Connector API
  version: 1.0.0
extends: openapi/hilt-so-hilt-payme-connector-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['/v1/connectors/grok/authorization'].get
  update:
    x-apievangelist-phrasing:
      intent: Review a pending Grok connector authorization
      effect: read
      questions:
      - What is the Grok connector asking permission to do on my PayMe account?
      - Can I inspect a Grok authorization request before approving it?
      instructions:
      - text: Show the Grok authorization request {request}.
        slots:
          request: query.request
      - text: Read what Grok request {request} wants access to.
        slots:
          request: query.request
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/connectors/grok/authorization'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve or deny a Grok connector authorization
      effect: write
      questions:
      - How do I let Grok connect to my PayMe account?
      - Can I reject a Grok connector request instead of approving it?
      instructions:
      - text: Approve Grok authorization request {request}.
        slots:
          request: requestBody.request
      - text: Set approval for Grok request {request} to {approved}.
        slots:
          request: requestBody.request
          approved: requestBody.approved
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/pay-me/connector-connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List my PayMe connector connections
      effect: read
      questions:
      - Which AI connectors are currently linked to my PayMe account?
      - Can I see every app I've connected to PayMe?
      instructions:
      - text: List my PayMe connector connections.
      - text: Show which connectors have access to my PayMe.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/pay-me/connector-connections/{connection_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect a PayMe connector
      effect: destructive
      questions:
      - How do I remove a connector's access to my PayMe account?
      - Can I revoke one connected app without affecting the others?
      instructions:
      - text: Disconnect PayMe connector {connection_id}.
        slots:
          connection_id: path.connection_id
      - text: Revoke connection {connection_id} from my PayMe account.
        slots:
          connection_id: path.connection_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/pay-me/payment-requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a payment through PayMe
      effect: write
      questions:
      - Can I ask someone on X to pay me a specific amount?
      - Will a PayMe payment request expire after a while?
      instructions:
      - text: Request {amount} {asset} via PayMe.
        slots:
          amount: requestBody.amount
          asset: requestBody.asset
      - text: Ask {from_x_handle} to pay me {amount} with note {note}.
        slots:
          from_x_handle: requestBody.from_x_handle
          amount: requestBody.amount
          note: requestBody.note
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/pay-me/payment-requests/{public_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a PayMe payment request
      effect: read
      questions:
      - Has my PayMe payment request been paid yet?
      - What amount and note are on a given payment request?
      instructions:
      - text: Show PayMe payment request {public_id}.
        slots:
          public_id: path.public_id
      - text: Check status of payment request {public_id}.
        slots:
          public_id: path.public_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/pay-me/payment-intents/{public_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a PayMe payment intent
      effect: read
      questions:
      - What's the state of a PayMe payment intent?
      - Can I look up a payment intent by its public ID?
      instructions:
      - text: Show PayMe payment intent {public_id}.
        slots:
          public_id: path.public_id
      - text: Get the details of intent {public_id}.
        slots:
          public_id: path.public_id
      method: generated
      generated: '2026-09-26'