CAcatmaid
client

Create or replace a key-value data entry for the client.

Changed on

Create or replace a key-value data entry for the client.

Each entry is associated with a datastore, an optional project, an optional user, and a key. Creating a request that duplicates this quadruple will replace rather than create the value in the key-value pair.

Entries associated with neither a project nor user are considered global; those associated with a project but no user are project- default; those associated with a user but no project are user-default; and those associated with both a project and a user are user-project specific. When listing key-value data, all four of these values, if existing, will be returned.

puthttp://localhost:8000/client/datastores/{name}/

Request

Path parameters

namestring required

String key for the datastore with which this key-value entry is associated.

Request body application/x-www-form-urlencoded

project_idstring

ID of a project to associate this data with, if any.

ignore_userstring

Whether to associate this key-value entry with the instance rather than the request user. Only project administrators can do this for project-associated instance data, and only super users can do this for global data (instance data not associated with any project).

keystring required

A key for this entry.

valuestring required

A value for this entry. Must be valid JSON.

formatstring

This function parameter is ignored

Response

OK

Changes