AI Applyd · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Aiapplyd Integrations API

5 actions 5 updates phrasing extends openapi/aiapplyd-integrations-api-openapi.yml

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/integrations/google/connect'].get

$.paths['/integrations/google/callback'].get

$.paths['/integrations/google/status'].get

$.paths['/integrations/google/disconnect'].post

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 Aiapplyd Integrations API
  version: 1.0.0
extends: openapi/aiapplyd-integrations-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: 4
- target: $.paths['/integrations/google/connect'].get
  update:
    x-apievangelist-phrasing:
      intent: Start connecting Gmail or Google Calendar
      effect: read
      questions:
      - How do I connect my Gmail so replies from employers are tracked?
      - Can I link Google Calendar for interview scheduling?
      instructions:
      - text: Get the Google connect URL for {services}.
        slots:
          services: query.services
      - text: 'Start connecting my Gmail and Calendar: {services}.'
        slots:
          services: query.services
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integrations/google/callback'].get
  update:
    x-apievangelist-phrasing:
      intent: Complete the Google authorization callback
      effect: write
      questions:
      - What happens after I approve access on the Google consent screen?
      - Where does Google send the authorization code after I connect?
      instructions:
      - text: Complete the Google connection with code {code} and state {state}.
        slots:
          code: query.code
          state: query.state
      - text: Handle the Google callback for state {state} with error {error}.
        slots:
          state: query.state
          error: query.error
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integrations/google/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check my Google integration status
      effect: read
      questions:
      - Is my Gmail still connected?
      - Which Google account and scopes are linked right now?
      instructions:
      - text: Show my Google integration status.
      - text: Check whether Gmail and Calendar are connected.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/integrations/google/disconnect'].post
  update:
    x-apievangelist-phrasing:
      intent: Disconnect Gmail or Google Calendar
      effect: destructive
      questions:
      - How do I unlink my Gmail?
      - Does disconnecting Google Calendar revoke its access token?
      instructions:
      - text: Disconnect Google service {service}.
        slots:
          service: requestBody.service
      - text: Revoke access for my {service} connection.
        slots:
          service: requestBody.service
      method: generated
      generated: '2026-09-26'