# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Sentry Seer API
  version: 1.0.0
extends: openapi/sentry-system-seer-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['/organizations/{organization_id_or_slug}/seer/models/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Seer AI models
      effect: read
      questions:
      - Which AI models can Seer use to analyze issues?
      - What models are available for Seer in my org?
      instructions:
      - text: List Seer AI models for {org}.
        slots:
          org: path.organization_id_or_slug
      - text: Show the models Seer can use in organization {org}.
        slots:
          org: path.organization_id_or_slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/issues/{issue_id}/seer/autofix/'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a Seer autofix's progress
      effect: read
      questions:
      - Has Seer finished its fix analysis for my issue?
      - What state is the AI autofix run in?
      instructions:
      - text: Get the Seer fix state for issue {issue_id}.
        slots:
          issue_id: path.issue_id
      - text: Check Seer autofix progress on issue {issue_id}.
        slots:
          issue_id: path.issue_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/issues/{issue_id}/seer/autofix/'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a Seer AI fix for an issue
      effect: write
      questions:
      - Can Seer suggest a code fix for an issue automatically?
      - Can I give Seer extra guidance when it starts a fix?
      instructions:
      - text: Start a Seer fix for issue {issue_id}.
        slots:
          issue_id: path.issue_id
      - text: Run Seer autofix on issue {issue_id} with instruction {instruction}.
        slots:
          issue_id: path.issue_id
          instruction: requestBody.instruction
      method: generated
      generated: '2026-09-26'