---
title: "PUT /documents/v2/datasets/{dataset_id}"
method: PUT
path: "/documents/v2/datasets/{dataset_id}"
tags: ["datasets"]
---

# PUT /documents/v2/datasets/{dataset_id}

`PUT /documents/v2/datasets/{dataset_id}`

## Path parameters

- `dataset_id` string, required

## Request body

- DatasetUpdateRequest
  - `parsing_options` ParsingOptions
    - `table_output_mode` 'markdown' | 'html'
    - `table_parsing_format` 'tsr' | 'vlm'
    - `chunking_strategy` 'none' | 'page' | 'section' | 'fragment'
    - `signature_detection` boolean — Flag to enable the detection of signatures in the document. This flag incurs additional billing costs. The default is `false`.
    - `remove_strikethrough_lines` boolean — Flag to enable the detection, and removal, of strikethrough text in the document. This flag incurs additional billing costs. The default is `false`.
    - `skew_detection` boolean — Boolean flag to detect and correct skewed or rotated pages in the document. The default is `false`. Setting this to `true` will increase the processing time of the document.
    - `disable_layout_detection` boolean — Disable bounding box detection for the document. Leads to faster document parsing. The default is `false`.
    - `ignore_sections` PageFragmentType[] — A set of page fragment types to ignore during parsing. This can be used to skip certain types of content that are not relevant for the parsing process, such as headers, footers, or other non-essential elements.
  - `structured_extraction_options` StructuredExtractionOptions[], nullable — The properties of this object define the configuration for structured data extraction. If this object is present, the API will perform structured data extraction on the document.
    - `schema_name` string, required — The name of the schema. This is used to tag the structured data output with a name in the response.
    - `json_schema` unknown, required
    - `skip_ocr` boolean — Boolean flag to skip converting the document blob to OCR text before structured data extraction. If set to `true`, the API will skip the OCR step and directly extract structured data from the document. The default is `false`.
    - `prompt` string, nullable — The prompt to use for structured data extraction. If not provided, the default prompt will be used.
    - `model_provider` 'tensorlake' | 'sonnet' | 'gpt4o_mini'
    - `partition_strategy` 'none' | 'page' | 'section' | 'fragment'
    - `page_classes` string[], nullable — Filter the pages of the document to be used for structured data extraction by providing a list of page classes. The default is `None`, which means all pages will be used.
  - `page_classifications` PageClassConfig[], nullable — The properties of this object define the configuration for page classification. If this object is present, the API will perform page classification on the document.
    - `name` string, required — The name of the page class.
    - `description` string, required — The description of the page class to guide the model to classify the pages. Describe what the model should look for in the page to classify it.
  - `enrichment_options` EnrichmentOptions
    - `table_summarization` boolean — Generate a summary for parsed tables. The default is `false`.
    - `table_summarization_prompt` string, nullable — The prompt to guide the table summarization. Ignored if `table_summarization` is `false`. Default prompt - "Summarize the table in a concise manner."
    - `figure_summarization` boolean — Generate a summary for parsed figures. The default is `false`.
    - `figure_summarization_prompt` string, nullable — The prompt to guide the figure summarization. Ignored if `figure_summarization` is `false`. Default prompt - "Summarize the figure in a concise manner."
  - `description` string, nullable — A description of the dataset. This field is optional and can be used to provide additional context about the dataset.

## Response `200`

Dataset updated successfully

- Dataset
  - `name` string, required — The name of the dataset. This is a human-readable name that identifies the dataset.
  - `dataset_id` string, required — The unique identifier for the dataset. This identifier is used to refer to the dataset in API endpoints and operations. This value is automatically generated and is unique within the organization and project context.
  - `description` string, nullable — An optional description of the dataset. This description is the one provided during dataset creation or update.
  - `status` 'idle' | 'processing', required
  - `created_at` string, required — The date and time when the dataset was created. The data is in RFC 3339 format (e.g., "2023-10-01T12:00:00Z").
  - `updated_at` string, required — The date and time when the dataset was last updated. The data is in RFC 3339 format (e.g., "2023-10-01T12:00:00Z").

## Other responses

- `400` — Invalid dataset update request
- `401` — Unauthorized. Invalid or missing credentials
- `403` — Forbidden. You do not have permission to access this resource
- `404` — Dataset not found
- `422` — Invalid properties in request body
- `500` — Internal server error

---

[API](https://skmtc.net/tensorlakeai/apis/tensorlake-api.md) · [All operations](https://skmtc.net/tensorlakeai/apis/tensorlake-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tensorlakeai/tensorlake-api/versions/fb161f7c0ab7/schema)