AI Applyd · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Aiapplyd Application Profile API

4 actions 4 updates phrasing extends openapi/aiapplyd-application-profile-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 4

$.info
$.paths['/application-profile'].get
$.paths['/application-profile'].put
$.paths['/application-profile/suggest'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Aiapplyd Application Profile API
  version: 1.0.0
extends: openapi/aiapplyd-application-profile-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: 3
- target: $.paths['/application-profile'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my job application profile
      effect: read
      questions:
      - What details will be used to fill in job applications for me?
      - Which address, links and work authorization are saved on my application profile?
      instructions:
      - text: Show my application profile.
      - text: Get the details I use for filling out job applications.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-profile'].put
  update:
    x-apievangelist-phrasing:
      intent: Update my job application profile
      effect: write
      questions:
      - How do I add my LinkedIn and GitHub links to my application profile?
      - Can I record my work authorization, notice period and willingness to relocate?
      - Where do I store voluntary answers like veteran or disability status?
      instructions:
      - text: Set my LinkedIn URL to {linkedinUrl} and GitHub URL to {githubUrl}.
        slots:
          linkedinUrl: requestBody.linkedinUrl
          githubUrl: requestBody.githubUrl
      - text: Update my work authorization to {workAuthorization} with notice period {noticePeriod}.
        slots:
          workAuthorization: requestBody.workAuthorization
          noticePeriod: requestBody.noticePeriod
      - text: Change my application address to {addressLine1}, {city}, {zipCode}.
        slots:
          addressLine1: requestBody.addressLine1
          city: requestBody.city
          zipCode: requestBody.zipCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/application-profile/suggest'].post
  update:
    x-apievangelist-phrasing:
      intent: Suggest application fields from my resume
      effect: read
      questions:
      - Can my current employer and years of experience be suggested from my resume?
      - Which application profile fields can be pre-filled from my parsed resume?
      instructions:
      - text: Suggest application profile fields from my latest resume.
      - text: Propose my employer, experience, education and work authorization from my resume.
      method: generated
      generated: '2026-09-26'