Bulk create dataset logs

POST

https://api.respan.ai/api/datasets/:dataset_id/logs/bulk/

POST

/api/datasets/:dataset_id/logs/bulk/

$ curl -X POST https://api.respan.ai/api/datasets/dataset_id/logs/bulk/ \
>      -H "Authorization: Bearer <respanApiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "logs": [
>     {
>       "input": "What is your return policy?",
>       "expected_output": "You can return within 30 days",
>       "metadata": {
>         "category": "support"
>       }
>     },
>     {
>       "input": [
>         {
>           "role": "user",
>           "content": "Hello"
>         }
>       ],
>       "output": {
>         "role": "assistant",
>         "content": "Hi there!"
>       },
>       "metrics": {
>         "tokens": 10,
>         "cost": 0.0001
>       }
>     }
>   ]
> }'

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

Create multiple dataset logs in one request from an array of unified-format log objects. Partial success is allowed.

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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

dataset_idstringRequired

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

Request

This endpoint expects an object.

logslist of objectsRequired

Response

Bulk create completed. Some rows may still contain errors.

success_countinteger

error_countinteger

errorslist of objects

total_errorsinteger

Errors

401

Unauthorized Error