---
title: "Import existing logs into a dataset"
method: POST
path: "/api/datasets/{dataset_id}/logs/import/"
tags: ["datasets"]
---

# Import existing logs into a dataset

`POST /api/datasets/{dataset_id}/logs/import/`

Import existing request logs into a dataset asynchronously using a time range, filters, and optional sampling.

## Path parameters

- `dataset_id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `start_time` string, date-time, required
  - `end_time` string, date-time, required
  - `filters` object — Platform-standard filters keyed by field name.
  - `sampling_percentage` integer — Percent of matching logs to import (1-100).

## Response `200`

Import started.

- DatasetsImportDatasetLogsResponse200
  - `message` string, required

## Other responses

- `400` — Bad request - invalid time range, filters, or plan limit exceeded.
- `401` — Unauthorized - Missing or invalid authentication.
- `404` — Dataset not found.

---

[API](https://skmtc.dev/respan/apis/api-reference.md) · [All operations](https://skmtc.dev/respan/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/respan/api-reference/revisions/764fca4d43e4/schema)
