# Create an ingestion

Adds a batch of data records to the specified dataset through an ingestion event.  

You can include up to 100 records per ingestion event.

The returned ingestionId values can be used with the corresponding ingestion details endpoint to retrieve more information the ingestion event.

Endpoint: POST /v1/datasets/{datasetId}/data
Version: v1
Security: x-api-key

## Path parameters:

  - `datasetId` (string, required)
    Unique identifier for the dataset.
    Example: "4e1219d8-7fa8-44b7-96c6-a8f2a9cfb0bf"

## Header parameters:

  - `Content-Type` (string, required)
    Must be set to application/json

## Request fields (application/json):

  - `records` (array, required)
    Aray of arbitrary key-value pairs representing a single event, item, or row.

## Response 200 fields (application/json):

  - `requestId` (string)
    Unique identifier for the request.
    Example: "b0eac937-c25c-47a5-bb7e-552f6b860458"

  - `status` (string)
    Indicates the status of the request.
    Example: "success"

  - `ingestionId` (string)
    Unique identifier for the ingestion event.
    Example: "8bfba187-84f4-41e2-9dd3-bee4bb884205"

  - `message` (string)
    Human-readable message describing the outcome of the request (for display/logging; not intended for programmatic parsing).
    Example: "Data ingestion request accepted"

## Response 400 fields (application/json):

  - `requestId` (string)
    Unique identifier for the request.
    Example: "b0eac937-c25c-47a5-bb7e-552f6b860458"

  - `status` (string)
    Indicates the status of the request.
    Example: "error"

  - `errors` (array)

  - `errors.code` (string,null)
    A machine-readable error code that identifies the type of error.
    Example: "invalid_input"

  - `errors.message` (string)
    A human-readable message explaining the error.
    Example: "The provided parameter is invalid."

  - `errors.field` (string)
    The name of the request field associated with the error, if applicable.
    Example: "datasetId"

  - `errors.type` (string)
    The category or context of the error, such as validation or permission.
    Example: "validation"

## Response 401 fields (application/json):

  - `requestId` (string)
    Unique identifier for the request.
    Example: "b0eac937-c25c-47a5-bb7e-552f6b860458"

  - `status` (string)
    Indicates the status of the request.
    Example: "error"

  - `errors` (array)

  - `errors.code` (string,null)
    A machine-readable error code that identifies the type of error.
    Example: "invalid_input"

  - `errors.message` (string)
    A human-readable message explaining the error.
    Example: "The provided parameter is invalid."

  - `errors.field` (string)
    The name of the request field associated with the error, if applicable.
    Example: "datasetId"

  - `errors.type` (string)
    The category or context of the error, such as validation or permission.
    Example: "validation"