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

# Send Bulk CSV to a Project Data Feed

> Uploads a CSV file to an ingestion Data Feed for processing. The Data Feed must have a "Endpoint" source configured. The file will be processed asynchronously through the pipeline's stages (collection, transformation, publication).




## OpenAPI

````yaml POST /data_feeds/{data_feed_friendly_id}
openapi: 3.1.0
info:
  title: Mangrove - API
  version: 1.1.0
servers:
  - url: https://app.gomangrove.com/api/v1
security:
  - sec0: []
paths:
  /data_feeds/{data_feed_friendly_id}:
    post:
      tags:
        - Data Ingestion
      summary: Submit a data file to an ingestion Data Feed
      description: >
        Uploads a CSV file to an ingestion Data Feed for processing. The Data
        Feed must have a "Endpoint" source configured. The file will be
        processed asynchronously through the pipeline's stages (collection,
        transformation, publication).
      operationId: submitDataFeed
      parameters:
        - name: data_feed_friendly_id
          in: path
          required: true
          description: The friendly ID of the data ingestion pipeline
          schema:
            type: string
            example: datafd_abc123def456
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - file
              properties:
                file:
                  type: string
                  format: binary
                  description: CSV file to upload (max 50MB)
            encoding:
              file:
                contentType: text/csv
      responses:
        '201':
          description: File successfully submitted and pipeline run started
          content:
            application/json:
              schema:
                type: object
                required:
                  - pipeline_run
                properties:
                  pipeline_run:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: The ID of the pipeline run
                        example: 123
                      stage:
                        type: string
                        description: Current stage of the pipeline run
                        enum:
                          - collection
                          - transformation
                          - publication
                          - completed
                        example: collection
                      started_at:
                        type: string
                        format: date-time
                        description: ISO 8601 timestamp when the pipeline run started
                        example: '2026-02-03T10:30:00Z'
                    required:
                      - id
                      - stage
                      - started_at
              example:
                pipeline_run:
                  id: 123
                  stage: collection
                  started_at: '2026-02-03T10:30:00Z'
        '401':
          description: Unauthorized - Invalid or missing API token
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
              example:
                error: Unauthorized
        '404':
          description: Pipeline not found
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
              example:
                error: Pipeline not found
        '422':
          description: Unprocessable Entity - Validation error
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
              examples:
                missingEndpoint:
                  summary: Submission endpoint not configured
                  value:
                    error: Submission endpoint is not configured for this pipeline
                missingFile:
                  summary: File parameter missing
                  value:
                    error: File parameter is required
                fileTooLarge:
                  summary: File exceeds size limit
                  value:
                    error: File size must be less than 50MB
                invalidFileType:
                  summary: File is not CSV
                  value:
                    error: Only CSV files are accepted
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: Authorization
      x-bearer-format: ''

````