Update a resource

patch

https://api.data.world/v0/metadata/resources/{owner}

Update a resource of any type in the organization. Properties that are not defined in the request are not updated. When updating properties that have a single value, the old value is replaced by the new value in the request. When updating properties that have a list of values, see "updateListBy" query parameter for more granular controls. To delete properties, use "Delete properties from a resource". To update multiple resources at once, use "Bulk: update multiple resources at once".

Path Params

owner

string

required

User name and unique identifier of the user or organization a resource belongs to. For example, in the URL: https://acme.data.world/jonloyens/an-intro-to-dataworld-dataset, jonloyens is the unique identifier of the owner.

Query Params

iri

string

required

Internationalized Resource Identifier (IRI) of the resource. You can find the IRI in the Technical Reference section under the Settings tab on the resource’s catalog page.

updateListBy

string

enum

required

Defaults to ADD

Set this option when updating properties that supports having a list of values. Given a list of values in the request body, should this request add to the existing list, remove the specified values, or replace the existing list with the specified values?

Allowed:

Body Params

collections

array of strings

Collections, identified by IRI, that this resource is added into. Required when creating a resource. Available collections can be discovered using "Search for resources" endpoint.

collections

properties

object

Create/update any property that is associated with a metadata presentation. Key is the IRI of the property. Value is the intended value of the property.

title

string

length between 1 and 120

Title of the resource. Required when creating a resource.

Response

Language

Credentials

Bearer

JWT

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200default response