package_update

Update a dataset (package).

You must be authorized to edit the dataset and the groups that it belongs to.

Note

Update methods may delete parameters not explicitly provided in the data_dict. If you want to edit only a specific attribute use package_patch instead.

It is recommended to call ckan.logic.action.get.package_show(), make the desired changes to the result, and then call package_update() with it.

Plugins may change the parameters of this function depending on the value of the dataset's type attribute, see the IDatasetForm plugin interface.

Authorization

apiTokenHeader

Authorization<token>

CKAN API token

In: header

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

id?string

the name or id of the dataset to update

name?string

the name of the new dataset, must be between 2 and 100 characters long and contain only lowercase alphanumeric characters, - and _

title?string

the title of the dataset (default: same as name)

private?boolean

if True creates a private dataset

author?string

the name of the dataset's author

author_email?string

the email address of the dataset's author

maintainer?string

the name of the dataset's maintainer

maintainer_email?string

the email address of the dataset's maintainer

license_id?string

the id of the dataset's license, see license_list() for available values

notes?string

a description of the dataset

url?string

a URL for the dataset's source

version?string

no longer than 100 characters

state?string

the current state of the dataset, e.g. 'active' or 'deleted', only active datasets show up in search results and other lists of datasets, thsi parameter will be ignored if you are not authorized to change the state of the dataset (default: 'active')

type?string

the type of the dataset, IDatasetForm plugins associate themselves with different dataset types and provide custom dataset handling behaviour for these types

resources?array<>

the dataset's resources

tags?array<>

the dataset's tags

extras?array<>

the dataset's extras, extras are arbitrary (key: value) metadata items that can be added to datasets, each extra dictionary should have keys 'key' (a string), 'value' (a string)

plugin_data?

Private package data belonging to plugins. Only sysadmin users may set this value. It should be a dict that can be dumped into JSON, and plugins should namespace their data with the plugin name to avoid collisions with other plugins, e.g.:

{
    "name": "test-dataset",
    "plugin_data": {
        "plugin1": {"key1": "value1"},
        "plugin2": {"key2": "value2"}
    }
}

relationships_as_object?array<>

list of relationship dictionaries

relationships_as_subject?array<>

list of relationship dictionaries

groups?array<>

the groups to which the dataset belongs, each group dictionary should have one or more of the following keys which identify an existing group: 'id' (the id of the group, string), or 'name' (the name of the group, string), to see which groups exist call group_list()

owner_org?string

the id of the dataset's owning organization, see organization_list() or organization_list_for_user() for available values. This parameter can be made optional if the config option ckan.auth.create_unowned_dataset is set to True.

curl -X PUT "http://localhost:5000/api/3/action/package_update"