Update a dataset

Changes dataset metadata or reports the content saved by the client.
Null fields stay unchanged.
A content update needs baseContentHash from the version that you opened.
Non-null schema, rowCount, columnCount, or contentHash triggers this check.
Null or empty baseContentHash matches only a null or empty stored hash.
Metadata-only changes do not require a matching base hash.
A content update returns 409 if the stored content hash no longer matches baseContentHash.
Updates without a replacement hash, or with the same hash, can still match the same base.
A new name must be unique by exact spelling in the project. Letter case matters.
The API stores these client-reported values as sent.
It does not compare them with Storage rows.
If a schema change affects variables that linked cases use, send confirm=true to continue.
Schema updates leave step text unchanged.
Send the saved content to Storage before this request.
Schema errors use code suffix 2703; reported limit errors use suffix 2702.
Requires the TestCase:Update permission.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Dataset UUID.

Query Params
boolean
Defaults to false

Confirm a schema change that affects variables used by linked cases.

Body Params
string | null

Dataset name. It must not be blank. Null leaves the current name unchanged.

string | null

Dataset description. Null leaves the current description unchanged.

schema
object | null

Reported column names and ordinals. Null leaves the current schema unchanged.

int32 | null
0 to 1000

Client-reported row count. The API does not compare this value with Storage rows. Limit errors use code suffix 2702.

int32 | null
0 to 50

Client-reported column count. If you send both this field and schema, the count must match the number of columns. Limit errors use code suffix 2702.

string | null

Client-reported hash of the content saved to Storage.

renames
array of objects | null

Explicit column renames. If omitted, the API compares column ordinals.

renames
string | null

Hash that you opened. Required for a content update; null or empty matches only a null or empty stored hash.

Headers
string

Optional account UUID for selecting account context explicitly.

int64

Optional organization ID for selecting organization context explicitly.

int64
required

True Platform project ID, not a repository ID.

Responses

401

Authentication is missing or invalid.

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Choose an example:
application/json