Bulk create dataset logs

Submit 1 to 500 dataset logs for ingestion in one request. Each log uses the same object as the single-create endpoint, and partial success is allowed. A 201 response can therefore contain item-level errors; if every item fails, the endpoint returns 400. Rate limit: 30 requests per minute per organization for API-key calls (shared across API keys) and per user for JWT calls.

Submit 1 to 500 dataset logs for ingestion in one request. Each log uses the same object as the single-create endpoint, and partial success is allowed. A `201` response can therefore contain item-level errors; if every item fails, the endpoint returns `400`. Rate limit: 30 requests per minute per organization for API-key calls (shared across API keys) and per user for JWT calls.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

dataset_idstringRequired

Dataset ID. Use _saved_logs for the virtual saved-logs collection.

Request

This endpoint expects an object.

logslist of objectsRequired

Dataset log objects to create. Items are processed independently and errors use their zero-based array index.

Response

At least one dataset log was accepted for ingestion. Inspect error_count and errors for partial failures.

success_countinteger>=0

Number of items successfully processed.

error_countinteger>=0

Number of items that failed.

errorslist of objects

Item-level failures, keyed by zero-based input index.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

$	curl -X POST https://api.respan.ai/api/datasets/dataset_abc123/logs/bulk/ \
>	-H "Authorization: Bearer <respanApiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"logs": [
>	{
>	"input": "What is your return policy?",
>	"expected_output": "You can return items within 30 days.",
>	"metadata": {
>	"category": "support"
>	}
>	},
>	{
>	"input": []
>	}
>	]
>	}'

1	{
2	"success_count": 1,
3	"error_count": 1,
4	"errors": [
5	{
6	"index": 1,
7	"error": "Invalid input format"
8	}
9	]
10	}