POST
/
v2
/
team
/
datasets
/
{id}

Authorizations

x-pd-api-key
string
header
required

Headers

x-pd-external-trace-id
string

The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.

Path Parameters

id
string
required

The ID of the dataset to modify. You can only modify the dataset that you created.

To check the datasets you have access to, call GET /v2/team/datasets.

Body

application/json
user_id
string
required

Your user ID, which uniquely identifies you within your team. To obtain your ID:

name
string

The new name of the dataset, which can be up to 128 characters in length. If it exceeds this limit, it will be truncated.

name and description cannot be both blank.

description
string

The new description of the dataset, which can be up to 50,000 characters in length. If it exceeds this limit, it will be truncated.

name and description cannot be both blank.

Response

200 - application/json
code
integer
required

Status code. 0 indicates that the operation is successful. Otherwise, the operation fails. For error troubleshooting, refer to Error Codes.

data
object
required

Null is returned when the operation is successful.