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

# Request a mailback report

> Queues a report request now. The tenant's registered mailback email and report password are used; the RTA then emails the report to the tenant's mailback address, where the inbound mailback pipeline ingests it. Returns 202 once queued — the report itself arrives later by email.



## OpenAPI

````yaml /openapi.yaml post /api/mailback-automation/v1/sources/{source}/requests
openapi: 3.0.3
info:
  title: MF Atlas API
  version: 1.0.0
servers:
  - description: Sandbox
    url: https://api-sandbox.mf-atlas.space
  - description: Production
    url: https://api.mf-atlas.space
security:
  - bearerAuth: []
paths:
  /api/mailback-automation/v1/sources/{source}/requests:
    post:
      tags:
        - mailback-automation
      summary: Request a mailback report
      description: >-
        Queues a report request now. The tenant's registered mailback email and
        report password are used; the RTA then emails the report to the tenant's
        mailback address, where the inbound mailback pipeline ingests it.
        Returns 202 once queued — the report itself arrives later by email.
      parameters:
        - description: Report source. Only cams today.
          in: path
          name: source
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              properties:
                report:
                  description: Report code to request, e.g. WBR53.
                  type: string
                timing:
                  description: >-
                    IMMEDIATE (the RTA mails the report within minutes) or
                    OVERNIGHT.
                  type: string
              required:
                - report
                - timing
              type: object
        description: Report and timing
        required: true
      responses:
        '202':
          content:
            application/json:
              schema:
                properties:
                  data:
                    properties:
                      created_at:
                        type: string
                      error:
                        type: string
                      id:
                        type: string
                      report:
                        type: string
                      source:
                        type: string
                      status:
                        description: >-
                          QUEUED (handed to the automation queue; the report
                          itself arrives by email) or FAILED (could not be
                          queued).
                        type: string
                      timing:
                        type: string
                      trigger:
                        description: ON_DEMAND or SCHEDULED.
                        type: string
                    required:
                      - created_at
                      - id
                      - report
                      - source
                      - status
                      - timing
                      - trigger
                    type: object
                  success:
                    type: boolean
                required:
                  - success
                type: object
          description: Queued request
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque bearer token from POST /api/auth/v1/token
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.