> ## Documentation Index > Fetch the complete documentation index at: https://docs.langchain.com/llms.txt > Use this file to discover all available pages before exploring further. # Dataset Handler ## OpenAPI ````yaml /langsmith/langsmith-platform-openapi.json post /api/v1/datasets/playground_experiment/batch openapi: 3.1.0 info: title: LangSmith description: >+ The LangSmith API is used to programmatically create and manage LangSmith resources. ## Host https://api.smith.langchain.com ## Authentication To authenticate with the LangSmith API, set the `X-Api-Key` header to a valid [LangSmith API key](https://docs.langchain.com/langsmith/create-account-api-key#create-an-api-key). version: 0.1.0 servers: - url: / security: [] tags: - name: run x-group: Tracing - name: runs x-group: Tracing - name: sessions x-group: Tracing - name: tracer-sessions x-group: Tracing - name: datasets x-group: Datasets - name: examples x-group: Datasets - name: evaluators x-group: Evaluation - name: experiment-view-overrides x-group: Evaluation - name: experiments x-group: Evaluation - name: annotation-queues x-group: Feedback & Annotation - name: annotation_queues x-group: Feedback & Annotation - name: feedback x-group: Feedback & Annotation - name: feedback-configs x-group: Feedback & Annotation - name: alert_rules x-group: Monitoring - name: bulk-exports x-group: Monitoring - name: charts x-group: Monitoring - name: commits x-group: Prompts & Playground - name: directories x-group: Prompts & Playground - name: hub_environments x-group: Prompts & Playground - name: playground-settings x-group: Prompts & Playground - name: prompt-webhooks x-group: Prompts & Playground - name: prompts x-group: Prompts & Playground - name: tag-transitions x-group: Prompts & Playground - name: comments x-group: Prompt Hub - name: likes x-group: Prompt Hub - name: optimization-jobs x-group: Prompt Hub - name: ownerships x-group: Prompt Hub - name: repos x-group: Prompt Hub - name: settings x-group: Prompt Hub - name: tags x-group: Prompt Hub - name: integrations x-group: Integrations & Tools - name: mcp x-group: Integrations & Tools - name: mcp_vendors x-group: Integrations & Tools - name: oauth x-group: Integrations & Tools - name: tools x-group: Integrations & Tools - name: gateway-policies x-group: LLM Gateway - name: sandboxes x-group: Sandboxes - name: issues x-group: Issues - name: issues-agent x-group: Issues - name: Organizations x-group: Administration - name: SCIM Tokens x-group: Administration - name: TTL Settings x-group: Administration - name: access_policies x-group: Administration - name: api-key x-group: Administration - name: audit-logs x-group: Administration - name: auth x-group: Administration - name: aws_marketplace x-group: Administration - name: data_planes x-group: Administration - name: me x-group: Administration - name: orgs x-group: Administration - name: service-accounts x-group: Administration - name: tenant x-group: Administration - name: ttl-settings x-group: Administration - name: usage-limits x-group: Administration - name: workspaces x-group: Administration - name: ace x-group: System - name: backfills x-group: System - name: features x-group: System - name: info x-group: System - name: model-price-map x-group: System - name: public x-group: System - name: threads x-group: System - name: agents x-hidden: true - name: beacon x-hidden: true - name: engine-trial - name: fleet - name: fleet auth x-hidden: true - name: fleet credentials x-hidden: true - name: fleet github-app x-hidden: true - name: fleet integrations x-hidden: true - name: fleet mcp x-hidden: true - name: fleet threads x-hidden: true - name: fleet trigger-templates x-hidden: true - name: fleet triggers x-hidden: true - name: fleet usage x-hidden: true - name: fleet_webhooks x-hidden: true - name: health - name: internal x-hidden: true - name: metrics x-hidden: true - name: nps x-hidden: true - name: sandboxes-internal x-hidden: true - name: skills x-hidden: true paths: /api/v1/datasets/playground_experiment/batch: post: tags: - datasets summary: Dataset Handler operationId: dataset_handler_api_v1_datasets_playground_experiment_batch_post requestBody: content: application/json: schema: $ref: '#/components/schemas/PlaygroundRunOverDatasetBatchRequestSchema' required: true responses: '200': description: Successful Response content: application/json: schema: title: >- Response Dataset Handler Api V1 Datasets Playground Experiment Batch Post '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - API Key: [] - Tenant ID: [] - Bearer Auth: [] components: schemas: PlaygroundRunOverDatasetBatchRequestSchema: properties: manifest: title: Manifest secrets: additionalProperties: type: string type: object title: Secrets run_id: anyOf: - type: string - type: 'null' title: Run Id repo_id: anyOf: - type: string - type: 'null' title: Repo Id tools: anyOf: - items: {} type: array - type: 'null' title: Tools tool_choice: anyOf: - type: string - type: 'null' title: Tool Choice parallel_tool_calls: anyOf: - type: boolean - type: 'null' title: Parallel Tool Calls options: $ref: '#/components/schemas/RunnableConfig' project_name: type: string title: Project Name repo_handle: anyOf: - type: string - type: 'null' title: Repo Handle owner: anyOf: - type: string - type: 'null' title: Owner commit: anyOf: - type: string - type: 'null' title: Commit evaluator_rules: anyOf: - items: type: string format: uuid type: array - type: 'null' title: Evaluator Rules requests_per_second: anyOf: - type: integer - type: 'null' title: Requests Per Second use_or_fallback_to_workspace_secrets: type: boolean title: Use Or Fallback To Workspace Secrets default: false runner_context: anyOf: - $ref: '#/components/schemas/RunnerContextEnum' - type: 'null' default: langsmith_ui dataset_id: type: string format: uuid title: Dataset Id dataset_splits: anyOf: - items: type: string type: array - type: 'null' title: Dataset Splits repetitions: type: integer maximum: 30 minimum: 1 title: Repetitions default: 1 metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata batch_size: anyOf: - type: integer maximum: 100 minimum: 1 - type: 'null' title: Batch Size type: object required: - manifest - secrets - options - project_name - dataset_id title: PlaygroundRunOverDatasetBatchRequestSchema HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError RunnableConfig: properties: tags: items: type: string type: array title: Tags metadata: additionalProperties: true type: object title: Metadata callbacks: anyOf: - items: {} type: array - {} - type: 'null' title: Callbacks run_name: type: string title: Run Name max_concurrency: anyOf: - type: integer - type: 'null' title: Max Concurrency recursion_limit: type: integer title: Recursion Limit configurable: additionalProperties: true type: object title: Configurable run_id: anyOf: - type: string format: uuid - type: 'null' title: Run Id type: object title: RunnableConfig description: |- Configuration for a `Runnable`. !!! note Custom values The `TypedDict` has `total=False` set intentionally to: - Allow partial configs to be created and merged together via `merge_configs` - Support config propagation from parent to child runnables via `var_child_runnable_config` (a `ContextVar` that automatically passes config down the call stack without explicit parameter passing), where configs are merged rather than replaced !!! example ```python # Parent sets tags chain.invoke(input, config={"tags": ["parent"]}) # Child automatically inherits and can add: # ensure_config({"tags": ["child"]}) -> {"tags": ["parent", "child"]} ``` RunnerContextEnum: type: string enum: - langsmith_ui - langsmith_align_evals title: RunnerContextEnum ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: API Key: type: apiKey in: header name: X-API-Key Tenant ID: type: apiKey in: header name: X-Tenant-Id Bearer Auth: type: http description: >- Bearer tokens are used to authenticate from the UI. Must also specify x-tenant-id or x-organization-id (for org scoped apis). scheme: bearer ````