Imports

Imports allow you to bulk import feedback data into the Feedier platform using CSV files. On this page, we'll dive into the different import endpoints that let you upload CSV files and track import status.

The import model

The import model contains all the information about a CSV import operation. It includes details about the import status, progress, and associated metadata.

Properties

Name
uuid
Type
string
Description
Unique identifier for the import (UUID format).
Name
name
Type
string
Description
The display name of the import as shown on the imports page.
Name
status
Type
string
Description
The current status of the import (e.g., pending, processing, completed, failed).
Name
feedback_import_uuid
Type
string
Description
The UUID of the target import, which can be found in the import details.
Name
created_at
Type
timestamp
Description
The date and time when the import was created.
Name
updated_at
Type
timestamp
Description
The date and time when the import was last updated.

POST/v3/imports/csv

Upload a CSV import

This endpoint allows you to upload a CSV file to create a new import. The CSV file will be processed according to the feedback import configuration specified by the feedback_import_uuid.

Before using this endpoint, you need to create an import manually in the Feedier platform. This will generate a feedback_import_uuid that you can then reuse via the API to replicate the same import configuration.

Required attributes

Name
file
Type
file
Description
The CSV file to upload. This should be sent as a multipart form-data file upload.
Name
feedback_import_uuid
Type
string
Description
The UUID of the target import, which can be found in the import details.
Name
name
Type
string
Description
The display name for this import. This name will be shown on the imports page in the Feedier dashboard.

Request

POST

/v3/imports/csv

curl https://api.bx.feedier.com/v3/imports/csv \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/json" \
    -F "file=@/path/to/your/import.csv" \
    -F "feedback_import_uuid=e4175386-dcdd-448b-8193-18c141b5fd5d" \
    -F "name=New import"

Response

{
    "uuid": "c88479d5-2dc8-47e0-9ac9-d79d76603750",
    "name": "New import",
    "status": "pending",
    "feedback_import_uuid": "e4175386-dcdd-448b-8193-18c141b5fd5d",
    "created_at": "2026-01-08T10:30:00.000000Z",
    "updated_at": "2026-01-08T10:30:00.000000Z"
}

GET/v3/imports/:uuid

Retrieve an import

This endpoint allows you to retrieve the details and status of a specific import by providing its unique identifier (UUID). Use this endpoint to track the progress of an import operation.

Path parameters

Name
uuid
Type
string
Description
The unique identifier (UUID) of the import to retrieve.

Request

GET

/v3/imports/c88479d5-2dc8-47e0-9ac9-d79d76603750

curl https://api.bx.feedier.com/v3/imports/c88479d5-2dc8-47e0-9ac9-d79d76603750 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/json"

Response

{
    "uuid": "c88479d5-2dc8-47e0-9ac9-d79d76603750",
    "name": "New import",
    "status": "completed",
    "feedback_import_uuid": "e4175386-dcdd-448b-8193-18c141b5fd5d",
    "rows_total": 150,
    "rows_processed": 150,
    "rows_succeeded": 148,
    "rows_failed": 2,
    "created_at": "2026-01-08T10:30:00.000000Z",
    "updated_at": "2026-01-08T10:35:00.000000Z"
}