openapi: 3.2.0
info:
  title: Resume Agent Availability API
  description: Query a candidate's professional profile. Use queryProfile for natural language questions, matchJob to score against a job description, and the GET endpoints for structured profile data.
  version: 1.0.0
servers:
- url: https://agent.yuens.me
tags:
- name: Availability
paths:
  /availability:
    get:
      operationId: getAvailability
      summary: Get current availability and preferred roles
      description: Returns whether the candidate is currently seeking work, their availability status, and preferred roles and locations. Use when asked "Are you open to work?" or "What roles are you looking for?"
      responses:
        '200':
          description: Availability status
          content:
            application/json:
              schema:
                type: object
                properties:
                  seeking:
                    type: boolean
                  status:
                    type: string
                    enum:
                    - open
                    - actively-looking
                    - not-looking
                  preferred_roles:
                    type: array
                    items:
                      type: string
                  remote:
                    type: boolean
      tags:
      - Availability