# reports_orgs_new_create

Creates and manages report generation requests.

This endpoint allows users to:
1. Request a new report generation
2. Check the status of a previously requested report
3. Force regeneration of an existing report

Reports expire after a configured time period (default is typically 24-48 hours).

Request Parameters:
    report_name (str): The identifier of the report to generate
    owner (str): The username of the report owner (usually the current user)
    learner_id (str, optional): Filter by specific learner
    course_id (str, optional): Filter by specific course
    start_date (str, optional): Start date for report data (ISO format)
    end_date (str, optional): End date for report data (ISO format)
    filters (dict, optional): Additional filters specific to the report type
    force (bool, optional): Force regeneration even if a valid report exists

Returns:
    For new reports:
        - report_id: The unique identifier for the report task
        - state: The current state of the report (PENDING, RUNNING, etc.)

    For completed reports:
        - report_id: The unique identifier for the report task
        - report_name: The name of the report
        - url: Download URL for the report
        - state: COMPLETED
        - expires: Expiration timestamp for the report

    For in-progress reports:
        - report_id: The unique identifier for the report task
        - state: Current state (PENDING, RUNNING)
        - started_on: When the report generation started
        - owner: Username of the report owner

Error Responses:
    400 Bad Request: Invalid parameters or report configuration
    404 Not Found: Report type not found
    403 Forbidden: User doesn't have permission for the requested report

Endpoint: POST /api/reports/orgs/{org}/new
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Path parameters:

  - `org` (string, required)

## Request fields (application/json):

  - `report_name` (string)
    Report slug, this is passed when calling the create report endpoint

  - `params` (object)
    Advanced report filtering. e,g: {'username': 'username1, username2' }

  - `query` (string)
    Advanced Query to run the report, supports SQL Like queries. 

e.g For date type filtering 
date_joined > '2021-01-01' 

See https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.query.html#pandas.DataFrame.query

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.report_id` (string)
    Used to download the report

  - `data.report_name` (string)
    Report slug, this is passed when calling the create report endpoint

  - `data.state` (string)
    Report States

*  - Pending
*  - Running
*  - Accumulating
*  - Processing
*  - Storing
*  - Completed
*  - Cancelled
*  - Error
*  - Expired
    Enum: "pending", "running", "accumulating", "processing", "storing", "completed", "cancelled", "error", "expired"

  - `data.started_on` (string)
    Report request timestamp (ISO 8601)

  - `data.owner` (string)
    Report Owner

  - `data.expires` (string)
    When report would expire and not available for download anymore

  - `data.url` (string)
    Download link for report when available