> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiotic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch all unread emails

> Manually trigger the email watcher to fetch all unread emails from the configured inbox and queue them for processing. Requires email configuration (IMAP settings) to be properly configured.




## OpenAPI

````yaml POST /email-watcher/fetch-all
openapi: 3.1.0
info:
  title: DocOpsAI API
  version: 0.1.0
  description: >
    AI-based order processing application that extracts information from email
    attachments and forwards to backend systems. Provides endpoints for order
    management, customer and product CRUD, email watching, and template
    parameter configuration.
  contact:
    name: DevOps Company
servers:
  - url: https://start.aiotic.ai
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: healthcheck
    description: Service health monitoring
  - name: order
    description: Order document upload and processing
  - name: order_status
    description: Order processing status tracking
  - name: customer
    description: Customer record management with vector search
  - name: product
    description: Product record management
  - name: template_parameters
    description: Prompt template parameter management
  - name: email-watcher
    description: Email inbox monitoring and processing
paths:
  /email-watcher/fetch-all:
    post:
      tags:
        - email-watcher
      summary: Fetch all unread emails
      description: >
        Manually trigger the email watcher to fetch all unread emails from the
        configured inbox and queue them for processing. Requires email
        configuration (IMAP settings) to be properly configured.
      operationId: fetchAllEmails
      responses:
        '200':
          description: Emails fetched and queued
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchAllEmailsResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    FetchAllEmailsResponse:
      type: object
      required:
        - status
        - emails_queued
        - emails_total
        - message
      properties:
        status:
          type: string
          description: Operation status
          example: success
        emails_queued:
          type: integer
          description: Number of emails queued for processing
        emails_total:
          type: integer
          description: Total number of unread emails found
        message:
          type: string
          description: Human-readable status message
    ErrorResponse:
      type: object
      required:
        - detail
      properties:
        detail:
          type: string
          description: Error message describing what went wrong
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >
        API key for authentication. Required on all endpoints except
        /healthcheck. Customer and product endpoints also accept a
        customer-specific API key.

````