# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Aiapplyd Outreach API
  version: 1.0.0
extends: openapi/aiapplyd-outreach-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['/outreach/job/{jobId}/contacts'].get
  update:
    x-apievangelist-phrasing:
      intent: Get hiring contacts for a saved job
      effect: read
      questions:
      - Who should I reach out to at a company for a job I saved but haven't applied to?
      - Can I see hiring contacts before submitting an application?
      instructions:
      - text: List outreach contacts for saved job {jobId}.
        slots:
          jobId: path.jobId
      - text: Show who to contact about saved job {jobId}.
        slots:
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/outreach/job/{jobId}/draft'].post
  update:
    x-apievangelist-phrasing:
      intent: Draft an outreach message for a saved job
      effect: write
      questions:
      - Can it write a message to a hiring contact for a job I only saved so far?
      - Does drafting outreach send the message for me?
      instructions:
      - text: Draft an outreach message to contact {contactId} for saved job {jobId}.
        slots:
          contactId: requestBody.contactId
          jobId: path.jobId
      - text: Write a pre-application DM to {contactId} about job {jobId}.
        slots:
          contactId: requestBody.contactId
          jobId: path.jobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/outreach/{applicationResultId}/contacts'].get
  update:
    x-apievangelist-phrasing:
      intent: Get hiring contacts for an application
      effect: read
      questions:
      - Who are the recruiters at the company I applied to?
      - How often are hiring contacts re-sourced for a company I've applied to?
      instructions:
      - text: List outreach contacts for application {applicationResultId}.
        slots:
          applicationResultId: path.applicationResultId
      - text: Find hiring contacts for my application {applicationResultId}.
        slots:
          applicationResultId: path.applicationResultId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/outreach/{applicationResultId}/draft'].post
  update:
    x-apievangelist-phrasing:
      intent: Draft an outreach message for an application
      effect: write
      questions:
      - Can I get a pre-filled email to a recruiter after I've applied?
      - Which channel does the drafted message use for a contact on my application?
      instructions:
      - text: Draft outreach to contact {contactId} for application {applicationResultId}.
        slots:
          contactId: requestBody.contactId
          applicationResultId: path.applicationResultId
      - text: Write a post-application message to {contactId} about {applicationResultId}.
        slots:
          contactId: requestBody.contactId
          applicationResultId: path.applicationResultId
      method: generated
      generated: '2026-09-26'