openapi: 3.0.0
info:
  title: Human Interface API
  version: 1.0.0
  description: Human-in-the-loop escalation endpoint for autonomous AI agents
  contact:
    email: contact@human-interface.ai
servers:
  - url: https://human-interface.ai/api
paths:
  /ping:
    get:
      summary: Health check
      responses:
        '200':
          description: Service is operational
          content:
            application/json:
              schema:
                type: object
                properties:
                  status: {type: string}
                  timestamp: {type: string, format: date-time}
  /status:
    get:
      summary: Service status
      responses:
        '200':
          description: Current service status
          content:
            application/json:
              schema:
                type: object
                properties:
                  status: {type: string}
                  uptime: {type: string}
                  last_updated: {type: string, format: date-time}
  /contact:
    post:
      summary: Submit mission request
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [name, email, objective]
              properties:
                name: {type: string}
                email: {type: string, format: email}
                objective: {type: string, minLength: 3}
                type: {type: string, nullable: true}
                location: {type: string, nullable: true}
                deadline: {type: string, nullable: true}
                budget: {type: string, nullable: true}
      responses:
        '200':
          description: Mission submitted
          content:
            application/json:
              schema:
                type: object
                properties:
                  id: {type: string, format: uuid}
                  status: {type: string}
                  created_at: {type: string, format: date-time}
