Skip to main content

site/properties (POST)


Create a site property

  • REST Method: POST
  • Method Access: public

Query Parameters

Name Type Description
authenticate bool? Force authentication for request (default: false)
abort {never, modified, exists}? Specifies condition under which to prevent the creation; default is exists.
redirects int? If zero, do not follow page redirects.
description string? Description of property

Return Codes

Name Value Description
OK 200 The request completed successfully
Bad Request 400 Invalid input parameter or request body
Forbidden 403 ADMIN access is required

Message Format

Input is an HTTP request containing a Slug header with the name of the property, a Content-Type header, a Content-Length, and the pro

POST /@api/deki/site/properties?description=description of foo
Host: wikihost
Slug: foo
Content-Type: image/jpg
Content-Length: 12345

... data here ...

Response is the standard property XML

<property name="{text}" href="{uri}" etag="{text}">
  <contents type="{text}" href="{uri}">{text}</contents>
  <user.modified id="{int}" href="{uri}">

Implementation Notes

  • The response XML will contain the contents text only for text based mimetypes with values less than 2048 chars in length. Otherwise the contents is available at the URI pointed to by property/contents/@href.
  • ADMIN right is required to read, create, or change a site property's value.

C# Code Sample: Add a Site Property

The following code authenticates and creates a new page property named 'foo' with a text value for the page 'My/Test/Page'. A description of the change is set as well.

Sample Code

Plug p = Plug.New("http://devwiki/@api/deki"); 
p.At("users", "authenticate")
 .WithCredentials("sysop", "password").Get(); 
p.At("site", "properties")
 .WithHeader("Slug", "foo")
 .With("description", "initial value") 
 .Post(DreamMessage.Ok(MimeType.TEXT_UTF8, "My Value"));

Sample Response from executing Code

<property name="foo" href="http://devwiki/@api/deki/site/properties/foo/info" etag="4463.r1_ts2009-03-20T22:48:15Z">
  <contents type="text/plain; charset=utf-8" href="http://devwiki/@api/deki/site/properties/foo">My Value</contents>
  <user.modified id="1" href="http://devwiki/@api/deki/users/1">
  <change-description>initial value</change-description>

Curl Code Sample: Add a Site Property

The following command adds a site property with property name "foo" and pairs it with the data from file "bar".

Sample Code

curl -u admin:password -H "Content-Type: text/plain" -H "Slug: foo" -d @bar -i http://mindtouch.address/@api/deki/site/properties

Implementation notes 

curl flags

Basic HTTP authentication. Sends a username and password to server so it can verify whether a user is of privilege to perform specific operation.
-d @file
Specifies a POST request and the data file to send.
Replaces or appends an HTTP header. The "Slug" header designates the property name. The "Content-Type" header specifies the MIME type of the value attached to the property.
Includes the HTTP response header in the output. Useful for debugging.


Properties can contain any type of file, therefore it is important to specify the correct MIME when creating a property. For instance, a text property will require a text/plain header, xml will require application/xml header, a jpeg image will require image/jpg header, and so on.


ADMIN permission is required to execute above command. Otherwise, a 403 HTTP response (Forbidden) will be returned.


We want to create a simple text property for the site. The property name will be "x" and the value will be "10", as outlined in "siteprop.txt". Think of it as high level variable storage.


Content-Type: text/plain


Sample Code

curl -u admin:password -H "Content-Type: text/plain" -H "Slug: x" -d @siteprop.txt -i

HTTP Response Headers

HTTP/1.1 200 OK
Date: Tue, 12 Jan 2010 01:52:37 GMT
Server: Dream-HTTPAPI/
X-Deki-Site: id="default"
Content-Type: application/xml; charset=utf-8
Content-Length: 643
Via: 1.1 dekiwiki

HTTP Response Body

Content-Type: application/xml

<?xml version="1.0"?>
<property name="x" href="" etag="36.r1_ts2010-01-12T01:52:36Z">
  <contents type="text/plain" size="2" href="">10</contents>
  <user.modified id="1" href="">


  • Was this article helpful?