<blueprint><assembly Version="11.1.0.8550" Culture="neutral" PublicKeyToken="b17e0197b56911d2">mindtouch.deki</assembly><class>MindTouch.Deki.DekiWikiService</class><name>MindTouch Core Service</name><copyright>Copyright (c) 2006-2010 MindTouch Inc.</copyright><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><sid>sid://mindtouch.com/2006/11/dekiwiki</sid><sid>http://services.mindtouch.com/deki/draft/2006/11/dekiwiki</sid><sid>http://www.mindtouch.com/services/2006/11/dekiwiki</sid><setup><private-storage /></setup><configuration><entry><name>imagemagick-identify-path</name><valuetype>string</valuetype><description>Path to ImageMagick identify tool</description></entry><entry><name>imagemagick-convert-path</name><valuetype>string</valuetype><description>Path to ImageMagick converter tool</description></entry><entry><name>deki-resources-path</name><valuetype>string?</valuetype><description>Path to resources folder (default: "%deki-path%/resources")</description></entry><entry><name>authtoken-salt</name><valuetype>string</valuetype><description>Private key used to generate unique auth tokens</description></entry><entry><name>admin-db-password</name><valuetype>string</valuetype><description>Database administrator password.</description></entry><entry><name>admin-db-user</name><valuetype>string?</valuetype><description>Database administrator user name (default: "root").</description></entry><entry><name>deki-sitename</name><valuetype>string?</valuetype><description>Site name (default: "MindTouch").</description></entry><entry><name>deki-language</name><valuetype>string?</valuetype><description>Site language (default: "en-US").</description></entry><entry><name>deki-path</name><valuetype>string</valuetype><description>Application installation folder</description></entry><entry><name>deki-temp-path</name><valuetype>string?</valuetype><description>Path for temporary files (default: system default temp folder)</description></entry><entry><name>deki-db-password</name><valuetype>string</valuetype><description>Password for database user.</description></entry><entry><name>deki-db-user</name><valuetype>string?</valuetype><description>Database user name (default: wikiuser).</description></entry><entry><name>deki-db-catalog</name><valuetype>string?</valuetype><description>Database table name (default: wikidb).</description></entry><entry><name>deki-db-port</name><valuetype>int?</valuetype><description>Database port (default: 3306).</description></entry><entry><name>deki-db-server</name><valuetype>string?</valuetype><description>Database host name (default: localhost).</description></entry><entry><name>max-image-size</name><valuetype>int?</valuetype><description>Maximum supported image size in bytes or 0 for no limit (default: 0).</description></entry><entry><name>deki-db-options</name><valuetype>string</valuetype><description>Optional connection string parameters</description></entry><entry><name>banned-words</name><valuetype>string?</valuetype><description>Comma separated list of banned words</description></entry><entry><name>deki-signature</name><valuetype>string?</valuetype><description>Puglic Digital Signature key to verify incoming requests from MindTouch. (default: none)</description></entry><entry><name>apikey</name><valuetype>string?</valuetype><description>Key to access protected features of the service.</description></entry><entry><name>uri.self</name><valuetype>uri</valuetype><description>Uri for current service (provided by Host).</description></entry><entry><name>service-license</name><valuetype>string?</valuetype><description>signed service-license</description></entry><entry><name>uri.log</name><valuetype>uri?</valuetype><description>Uri for logging service.</description></entry></configuration><features><feature><pattern>GET:contexts</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetContextDefinitions</method><param><name>description</name><valuetype>string?</valuetype><description></description></param><param><name>contextid</name><valuetype>string?</valuetype><description></description></param><status value="403">Read access to the page is required</status><status value="200">The request completed successfully</status><status value="404">The requested page could not be found</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>POST:contexts</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostContextDefinitions</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="404">The requested page could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:contexts/{id}</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetContextDefinition</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>id</name><valuetype>string</valuetype><description></description></param><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">The requested page could not be found</status><access>public</access></feature><feature><pattern>PUT:contexts/{id}</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutContextDefinition</method><param><name>id</name><valuetype>string</valuetype><description></description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">The requested page could not be found</status><access>public</access></feature><feature><pattern>DELETE:contexts/{id}</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteContextDefinition</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>id</name><valuetype>string</valuetype><description></description></param><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">The requested page could not be found</status><access>public</access></feature><feature><pattern>GET:contextmaps</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetContextMaps</method><param><name>verbose</name><valuetype>bool?</valuetype><description>return verbose page information (default: false)</description></param><param><name>languagesonly</name><valuetype>bool?</valuetype><description></description></param><param><name>contextid</name><valuetype>string?</valuetype><description></description></param><param><name>mapped</name><valuetype>bool?</valuetype><description></description></param><param><name>language</name><valuetype>string?</valuetype><description></description></param><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">The requested page could not be found</status><access>public</access></feature><feature><pattern>GET:contextmaps/{language}/{id}</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetContextMap</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>verbose</name><valuetype>bool?</valuetype><description>return verbose information (default: false)</description></param><param><name>id</name><valuetype>string</valuetype><description></description></param><param><name>language</name><valuetype>string</valuetype><description></description></param><status value="200">The request completed successfully</status><status value="404">The requested mapping could not be found</status><status value="400">Invalid input parameter or request body</status><status value="403">Read access to the mapping is required</status><access>public</access></feature><feature><pattern>PUT:contextmaps/{language}/{id}</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutContextMap</method><param><name>language</name><valuetype>string</valuetype><description></description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>verbose</name><valuetype>bool?</valuetype><description>return verbose information (default: false)</description></param><param><name>id</name><valuetype>string</valuetype><description></description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">The requested mapping could not be found</status><status value="403">Read access to the mapping is required</status><access>public</access></feature><feature><pattern>DELETE:contextmaps/{language}/{id}</pattern><description></description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteContextMap</method><param><name>language</name><valuetype>string</valuetype><description></description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>id</name><valuetype>string</valuetype><description></description></param><status value="404">The requested page could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:host/stop</pattern><description>Stop  the request associate tenant, if running</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostHostInstanceStop</method><access>internal</access></feature><feature><pattern>POST:host/stop/{wikiid}</pattern><description>Stop the requested tenant, if running</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostHostInstanceStopByWikiId</method><access>internal</access></feature><feature><pattern>GET:host</pattern><description>Get all currently running tenants</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetHostInstances</method><access>internal</access></feature><feature><pattern>GET:site/opensearch/description</pattern><description>Get the OpenSearch Description document</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSearchDescription</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><access>public</access></feature><feature><pattern>GET:site/opensearch</pattern><description>Search the site index</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>OpenSearch</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>nocache</name><valuetype>bool?</valuetype><description>Use caching search path (better for paging results)  (default: false)</description></param><param><name>parser</name><valuetype>{bestguess|term|filename|lucene}?</valuetype><description>The parser to use for the query  (default: bestguess)</description></param><param><name>constraint</name><valuetype>string?</valuetype><description>Additional search constraint (ex: language:en-us AND type:wiki) default: none</description></param><param><name>sortby</name><valuetype>{score, title, date, size, wordcount, rating.score, rating.count}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. default: -score</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>format</name><valuetype>{rss | atom}?</valuetype><description>search output format (rss | atom) default: atom</description></param><param><name>q</name><valuetype>string</valuetype><description>lucene search string</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:site/opensearch/suggestions</pattern><description>Search the site index</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>OpenSearchSuggest</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>constraint</name><valuetype>string?</valuetype><description>Additional search constraint (ex: language:en-us AND type:wiki) default: none</description></param><param><name>sortby</name><valuetype>{score, title, date, size, wordcount, rating.score, rating.count}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. default: -score</description></param><param><name>q</name><valuetype>string</valuetype><description>lucene search string</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:site/search</pattern><description>Search the site index</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>SearchIndex</method><param><name>parser</name><valuetype>{bestguess|term|filename|lucene}?</valuetype><description>The parser to use for the query  (default: bestguess)</description></param><param><name>sortby</name><valuetype>{score, title, date, size, wordcount, rating.score, rating.count}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. default: -score</description></param><param><name>nocache</name><valuetype>bool?</valuetype><description>Use caching search path (better for paging results)  (default: false)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>format</name><valuetype>{xml | search}?</valuetype><description>search output format (xml | search) default: xml</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>q</name><valuetype>string</valuetype><description>lucene search string</description></param><param><name>constraint</name><valuetype>string?</valuetype><description>Additional search constraints (ex: language:en-us AND type:wiki) default: none</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><param><name>verbose</name><valuetype>bool?</valuetype><description>show verbose page xml. default: true</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/query</pattern><description>Search the site index with analytical tracking. Primarily for user facing search.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetRankedSearch</method><param><name>q</name><valuetype>string</valuetype><description>lucene search string</description></param><param><name>notrack</name><valuetype>bool?</valuetype><description>Disable analytics query tracking (default: false)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>explain</name><valuetype>bool?</valuetype><description>Include ranking details (default: false)</description></param><param><name>constraint</name><valuetype>string?</valuetype><description>Additional search constraints (ex: language:en-us AND type:wiki) default: none</description></param><param><name>sortby</name><valuetype>{rank, title, modified}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. (default: -rank)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Maximum number of items to retrieve. Must be a positive number (default: 25)</description></param><param><name>previousqueryid</name><valuetype>ulong?</valuetype><description>Query tracking id of previous query, if this is a follow-up query</description></param><param><name>parser</name><valuetype>{bestguess|term|lucene}?</valuetype><description>The parser to use for the query  (default: bestguess)</description></param><param><name>queryid</name><valuetype>ulong?</valuetype><description>Query tracking id returned by original query result (used for paging/changing sort order)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:site/query/{queryid}</pattern><description>Register a tracked search result selection.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostSearchResultAnalytics</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>typeid</name><valuetype>uint?</valuetype><description>Id of type (if not 'page'</description></param><param><name>type</name><valuetype>{page,file,comment}</valuetype><description>Type of result</description></param><param><name>position</name><valuetype>ushort?</valuetype><description>Search result position</description></param><param><name>pageid</name><valuetype>uint</valuetype><description>Page id where the result occured</description></param><param><name>rank</name><valuetype>double</valuetype><description>Search result rank</description></param><param><name>notrack</name><valuetype>bool?</valuetype><description>Disable analytics query tracking (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/query/log</pattern><description>Get tracked search data.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetTrackedSearches</method><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Maximum number of items to retrieve. Must be a positive number (default: 25)</description></param><param><name>before</name><valuetype>string?</valuetype><description>End date for result set.  Date is provided in 'yyyyMMddHHmmss' format (default: now).</description></param><param><name>lowquality</name><valuetype>bool?</valuetype><description>Find searches that have 0 or more than 3 result</description></param><param><name>since</name><valuetype>string?</valuetype><description>Start date for result set.  Date is provided in 'yyyyMMddHHmmss' format (default: one month ago).</description></param><param><name>term</name><valuetype>string?</valuetype><description>Find searches containing a specific term.</description></param><param><name>query</name><valuetype>string?</valuetype><description>Find searches using the given query term string (overrides 'term')</description></param><param><name>groupby</name><valuetype>{query}?</valuetype><description>Aggregate by query</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>internal</access></feature><feature><pattern>GET:site/query/log/terms</pattern><description>Get tracked search terms</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetTrackedSearchTerms</method><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>lowquality</name><valuetype>bool?</valuetype><description>Find searches that have 0 or more than 1 result</description></param><param><name>before</name><valuetype>string?</valuetype><description>End date for result set.  Date is provided in 'yyyyMMddHHmmss' format (default: now).</description></param><param><name>since</name><valuetype>string?</valuetype><description>Start date for result set.  Date is provided in 'yyyyMMddHHmmss' format (default: one month ago).</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Maximum number of items to retrieve. Must be a positive number (default: 25)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>internal</access></feature><feature><pattern>GET:site/query/log/{queryid}</pattern><description>Get tracked search detail</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetTrackedSearchDetail</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>since</name><valuetype>string?</valuetype><description>Start date for querystring based aggregation.  Date is provided in 'yyyyMMddHHmmss' format (default: one month ago).</description></param><param><name>before</name><valuetype>string?</valuetype><description>End date for querystring based aggregation.  Date is provided in 'yyyyMMddHHmmss' format (default: now).</description></param><param><name>queryid</name><valuetype>string</valuetype><description>Either the unique query id, or the aggregated, sorted querystring prefixed with an =</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>internal</access></feature><feature><pattern>GET:site/query/recommendations</pattern><description>Retrieve search recommendations</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSearchRecommendations</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Maximum number of items to retrieve. Must be a positive number (default: 25)</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:site/query/recommendations</pattern><description>Add a search recommendation</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>AddSearchRecommendations</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="403">MindTouch API key or Administrator access is required.</status><access>public</access></feature><feature><pattern>GET:site/query/recommendations/{id}</pattern><description>Retrieve search recommendations</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSearchRecommendation</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Maximum number of items to retrieve. Must be a positive number (default: 25)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><status value="200">The request completed successfully</status><status value="403">MindTouch API key or Administrator access is required.</status><access>public</access></feature><feature><pattern>PUT:site/query/recommendations/{id}</pattern><description>Update a search recommendation</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>UpdateSearchRecommendations</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="403">MindTouch API key or Administrator access is required.</status><access>public</access></feature><feature><pattern>DELETE:site/query/recommendations/{id}</pattern><description>Update a search recommendation</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteSearchRecommendations</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/search/rebuild</pattern><description>Return rebuild information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetRebuildInformation</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:site/search/rebuild</pattern><description>Rebuild the site index</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>RebuildIndex</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="403">MindTouch API key or Administrator access is required.</status><access>internal</access></feature><feature><pattern>POST:site/search/repair</pattern><description>Repair the site index</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>RepairIndex</method><param><name>checkonly</name><valuetype>bool?</valuetype><description>Report on entities that need to be repaired, but do not execute repair (default: false)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>verbose</name><valuetype>bool?</valuetype><description>Report on all entities considered, whether or not repair was required (default: false)</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="200">The request completed successfully</status><access>internal</access></feature><feature><pattern>GET:site/bans</pattern><description>Get a list of all IP and user bans</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetBans</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">Request completed successfully</status><status value="403">ADMIN access is required</status><access>public</access></feature><feature><pattern>GET:site/bans/{banid}</pattern><description>See a specific ban entry</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetBan</method><param><name>{banid}</name><valuetype>int</valuetype><description>Identifies a ban by ID</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">Request completed successfully</status><status value="403">ADMIN access is required</status><status value="404">Ban ID does not exist</status><access>public</access></feature><feature><pattern>POST:site/bans</pattern><description>Create a ban entry</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostBans</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">ADMIN access is required</status><status value="200">Request completed successfully</status><status value="400">Invalid request body</status><access>public</access></feature><feature><pattern>DELETE:site/bans/{banid}</pattern><description>Remove a ban entry</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteBan</method><param><name>{banid}</name><valuetype>int</valuetype><description>Identifies a ban by ID</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">Ban ID does not exist</status><status value="403">ADMIN access is required</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>GET:comments/{commentid}</pattern><description>Retrieve a comment and metadata</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetComment</method><param><name>{commentnumber}</name><valuetype>int?</valuetype><description>identifies the comment on the page</description></param><param><name>{pageid}</name><valuetype>string?</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{commentid}</name><valuetype>int?</valuetype><description>identifies the comment by its unique id</description></param><status value="404">Requested comment could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/comments/{commentnumber}</pattern><description>Retrieve a comment and metadata</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetComment</method><param><name>{commentnumber}</name><valuetype>int?</valuetype><description>identifies the comment on the page</description></param><param><name>{pageid}</name><valuetype>string?</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{commentid}</name><valuetype>int?</valuetype><description>identifies the comment by its unique id</description></param><status value="404">Requested comment could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/comments/{commentnumber}/content</pattern><description>Retrieve the comment text only</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetCommentContent</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{commentnumber}</name><valuetype>int</valuetype><description>identifies the comment on the page</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">The requested comment could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/comments</pattern><description>Retrieve the comments on a page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageComments</method><param><name>depth</name><valuetype>string?</valuetype><description>Use 'infinity' to return comments from all descendant pages. (default: 0)</description></param><param><name>sortby</name><valuetype>{date.posted}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. (default: date.posted)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><param><name>filter</name><valuetype>string?</valuetype><description>Comments to return: any, nondeleted. default: nondeleted</description></param><param><name>format</name><valuetype>{xml, atom}?</valuetype><description>Output format (default: xml).</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>postedbyuserid</name><valuetype>int?</valuetype><description>Only return comments posted by the id of a user</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="404">The requested page could not be found</status><status value="403">Read access to the page is required</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/comments/{commentnumber}/content</pattern><description>Edit the specified comment</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutCommentContent</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{commentnumber}</name><valuetype>int</valuetype><description>identifies the comment on the page</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="200">The request completed successfully</status><status value="404">The requested comment could not be found</status><status value="403">Administrator access or comment author is required</status><status value="400">Invalid input parameter or request body (must be text MIME type)</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/comments</pattern><description>Post a new comment to a page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageComment</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>title</name><valuetype>string?</valuetype><description>Title for comment</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">The requested page could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body (must be text MIME type)</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:pages/{pageid}/comments/{commentnumber}</pattern><description>Mark a comment as being deleted. This hides comment content from non admins</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteComment</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{commentnumber}</name><valuetype>int</valuetype><description>identifies the comment on the page</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="200">The request completed successfully</status><status value="404">The requested comment could not be found</status><status value="403">Administrator access or comment author is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:files</pattern><description>Retrieve information for all attached files</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFiles</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>skip</name><valuetype>int?</valuetype><description>Number of files to skip. Default: 0</description></param><param><name>numfiles</name><valuetype>int?</valuetype><description>Number of files to retrieve. 'ALL' for no limit. Default: 100</description></param><status value="403">Read access to the page sis required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:files/{fileid}/info</pattern><description>Retrieve file attachment information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFileInfo</method><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/files/{filename}/info</pattern><description>Retrieve file attachment information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFileInfo</method><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>OPTIONS:files/{fileid}</pattern><description>Retrieve available HTTP options</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetOptions</method><access>public</access></feature><feature><pattern>OPTIONS:pages/{pageid}/files/{filename}</pattern><description>Retrieve available HTTP options</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetOptions</method><access>public</access></feature><feature><pattern>OPTIONS:files/{fileid}/{filename}</pattern><description>Retrieve available HTTP options</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetOptions</method><access>public</access></feature><feature><pattern>UNLOCK:files/{fileid}</pattern><description>Unlock file (always returns 204)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>UnLockFile</method><access>public</access></feature><feature><pattern>UNLOCK:pages/{pageid}/files/{filename}</pattern><description>Unlock file (always returns 204)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>UnLockFile</method><access>public</access></feature><feature><pattern>UNLOCK:files/{fileid}/{filename}</pattern><description>Unlock file (always returns 204)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>UnLockFile</method><access>public</access></feature><feature><pattern>LOCK:files/{fileid}</pattern><description>Lock file (always returns 200, mirroring the request document)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>LockFile</method><access>public</access></feature><feature><pattern>LOCK:pages/{pageid}/files/{filename}</pattern><description>Lock file (always returns 200, mirroring the request document)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>LockFile</method><access>public</access></feature><feature><pattern>LOCK:files/{fileid}/{filename}</pattern><description>Lock file (always returns 200, mirroring the request document)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>LockFile</method><access>public</access></feature><feature><pattern>PROPFIND:files/{fileid}/{filename}</pattern><description>Lock file (always returns 412 - Precondition Failed)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PropfindFile</method><access>public</access></feature><feature><pattern>PROPFIND:pages/{pageid}/files/{filename}</pattern><description>Lock file (always returns 412 - Precondition Failed)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PropfindFile</method><access>public</access></feature><feature><pattern>PROPFIND:files/{fileid}</pattern><description>Lock file (always returns 412 - Precondition Failed)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PropfindFile</method><access>public</access></feature><feature><pattern>PROPFIND:files</pattern><description>Lock file (always returns 412 - Precondition Failed)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PropfindDirectory</method><access>public</access></feature><feature><pattern>GET:pages/{pageid}/files/{filename}</pattern><description>Retrieve file attachment content</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFile</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>size</name><valuetype>{original, thumb, webview, bestfit, custom}?</valuetype><description>Return a resized image from one of the preset cached sizes. Use 'thumb' or 'webview' to return a smaller scaled image. Use 'bestfit' along with height/width to return one of the known sizes being at least the size given. Default: original</description></param><param><name>format</name><valuetype>{jpg, png, bmp, gif}?</valuetype><description>Convert output to given type. Default is to use original type.</description></param><param><name>ratio</name><valuetype>{fixed, var}?</valuetype><description>Fixed preserves aspect ratio by applying height and width as bounding maximums rather than absolute values. Variable will use the width and height given. Default: fixed</description></param><param><name>width</name><valuetype>int?</valuetype><description>Width of the image</description></param><param><name>height</name><valuetype>int?</valuetype><description>Height of the image</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="501">Requested operation is not currently supported</status><access>public</access></feature><feature><pattern>HEAD:files/{fileid}/{filename}</pattern><description>Retrieve file attachment content (Note: image manipulation arguments are ignored for HEAD requests)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFile</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>size</name><valuetype>{original, thumb, webview, bestfit, custom}?</valuetype><description>Return a resized image from one of the preset cached sizes. Use 'thumb' or 'webview' to return a smaller scaled image. Use 'bestfit' along with height/width to return one of the known sizes being at least the size given. Default: original</description></param><param><name>format</name><valuetype>{jpg, png, bmp, gif}?</valuetype><description>Convert output to given type. Default is to use original type.</description></param><param><name>ratio</name><valuetype>{fixed, var}?</valuetype><description>Fixed preserves aspect ratio by applying height and width as bounding maximums rather than absolute values. Variable will use the width and height given. Default: fixed</description></param><param><name>width</name><valuetype>int?</valuetype><description>Width of the image</description></param><param><name>height</name><valuetype>int?</valuetype><description>Height of the image</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="501">Requested operation is not currently supported</status><access>public</access></feature><feature><pattern>HEAD:files/{fileid}</pattern><description>Retrieve file attachment content (Note: image manipulation arguments are ignored for HEAD requests)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFile</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>size</name><valuetype>{original, thumb, webview, bestfit, custom}?</valuetype><description>Return a resized image from one of the preset cached sizes. Use 'thumb' or 'webview' to return a smaller scaled image. Use 'bestfit' along with height/width to return one of the known sizes being at least the size given. Default: original</description></param><param><name>format</name><valuetype>{jpg, png, bmp, gif}?</valuetype><description>Convert output to given type. Default is to use original type.</description></param><param><name>ratio</name><valuetype>{fixed, var}?</valuetype><description>Fixed preserves aspect ratio by applying height and width as bounding maximums rather than absolute values. Variable will use the width and height given. Default: fixed</description></param><param><name>width</name><valuetype>int?</valuetype><description>Width of the image</description></param><param><name>height</name><valuetype>int?</valuetype><description>Height of the image</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="501">Requested operation is not currently supported</status><access>public</access></feature><feature><pattern>HEAD:pages/{pageid}/files/{filename}</pattern><description>Retrieve file attachment content (Note: image manipulation arguments are ignored for HEAD requests)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFile</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>size</name><valuetype>{original, thumb, webview, bestfit, custom}?</valuetype><description>Return a resized image from one of the preset cached sizes. Use 'thumb' or 'webview' to return a smaller scaled image. Use 'bestfit' along with height/width to return one of the known sizes being at least the size given. Default: original</description></param><param><name>format</name><valuetype>{jpg, png, bmp, gif}?</valuetype><description>Convert output to given type. Default is to use original type.</description></param><param><name>ratio</name><valuetype>{fixed, var}?</valuetype><description>Fixed preserves aspect ratio by applying height and width as bounding maximums rather than absolute values. Variable will use the width and height given. Default: fixed</description></param><param><name>width</name><valuetype>int?</valuetype><description>Width of the image</description></param><param><name>height</name><valuetype>int?</valuetype><description>Height of the image</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="501">Requested operation is not currently supported</status><access>public</access></feature><feature><pattern>GET:files/{fileid}/{filename}</pattern><description>Retrieve file attachment content</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFile</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>size</name><valuetype>{original, thumb, webview, bestfit, custom}?</valuetype><description>Return a resized image from one of the preset cached sizes. Use 'thumb' or 'webview' to return a smaller scaled image. Use 'bestfit' along with height/width to return one of the known sizes being at least the size given. Default: original</description></param><param><name>format</name><valuetype>{jpg, png, bmp, gif}?</valuetype><description>Convert output to given type. Default is to use original type.</description></param><param><name>ratio</name><valuetype>{fixed, var}?</valuetype><description>Fixed preserves aspect ratio by applying height and width as bounding maximums rather than absolute values. Variable will use the width and height given. Default: fixed</description></param><param><name>width</name><valuetype>int?</valuetype><description>Width of the image</description></param><param><name>height</name><valuetype>int?</valuetype><description>Height of the image</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="501">Requested operation is not currently supported</status><access>public</access></feature><feature><pattern>GET:files/{fileid}</pattern><description>Retrieve file attachment content</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFile</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>size</name><valuetype>{original, thumb, webview, bestfit, custom}?</valuetype><description>Return a resized image from one of the preset cached sizes. Use 'thumb' or 'webview' to return a smaller scaled image. Use 'bestfit' along with height/width to return one of the known sizes being at least the size given. Default: original</description></param><param><name>format</name><valuetype>{jpg, png, bmp, gif}?</valuetype><description>Convert output to given type. Default is to use original type.</description></param><param><name>ratio</name><valuetype>{fixed, var}?</valuetype><description>Fixed preserves aspect ratio by applying height and width as bounding maximums rather than absolute values. Variable will use the width and height given. Default: fixed</description></param><param><name>width</name><valuetype>int?</valuetype><description>Width of the image</description></param><param><name>height</name><valuetype>int?</valuetype><description>Height of the image</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="501">Requested operation is not currently supported</status><access>public</access></feature><feature><pattern>GET:files/{fileid}/revisions</pattern><description>Retrieve file revision info</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFileRevisions</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>changefilter</name><valuetype>string?</valuetype><description>Only show revisions having a user-action listed in this comma delimited list. Valid actions are: CONTENT, NAME, LANGUAGE, META, DELETEFLAG, PARENT (default: all actions)</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/files/{filename}/revisions</pattern><description>Retrieve file revision info</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFileRevisions</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>changefilter</name><valuetype>string?</valuetype><description>Only show revisions having a user-action listed in this comma delimited list. Valid actions are: CONTENT, NAME, LANGUAGE, META, DELETEFLAG, PARENT (default: all actions)</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><access>public</access></feature><feature><pattern>POST:files/{fileid}/revisions</pattern><description>Performs operations such as hide/unhide for revisions of files</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostFileRevisions</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>comment</name><valuetype>string?</valuetype><description>Reason for hiding revisions</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="403">DELETE access is required to hide a revision and ADMIN access to unhide</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested file could not be found</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/files/{filename}/revisions</pattern><description>Performs operations such as hide/unhide for revisions of files</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostFileRevisions</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>comment</name><valuetype>string?</valuetype><description>Reason for hiding revisions</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="403">DELETE access is required to hide a revision and ADMIN access to unhide</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested file could not be found</status><access>public</access></feature><feature><pattern>PUT:files/{fileid}/{filename}</pattern><description>Replace an existing attachment with a new version</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutFile</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>description</name><valuetype>string?</valuetype><description>file attachment description</description></param><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>PUT:files/{fileid}</pattern><description>Replace an existing attachment with a new version</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutFile</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>description</name><valuetype>string?</valuetype><description>file attachment description</description></param><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/files/{filename}</pattern><description>Replace an existing attachment with a new version or create a new attachment</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutFile</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>description</name><valuetype>string?</valuetype><description>file attachment description</description></param><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>POST:files/{fileid}/move</pattern><description>Move an attachment from one page to another and/or change the filename</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostFileMove</method><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>name</name><valuetype>string?</valuetype><description>new filename</description></param><param><name>to</name><valuetype>string?</valuetype><description>page id of target page</description></param><status value="404">Requested file could not be found</status><status value="403">Update access to the page is required</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>POST:files/{fileid}/copy</pattern><description>Copy an attachment from one page to another and/or change the filename</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostFileMove</method><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>name</name><valuetype>string?</valuetype><description>new filename</description></param><param><name>to</name><valuetype>string?</valuetype><description>page id of target page</description></param><status value="404">Requested file could not be found</status><status value="403">Update access to the page is required</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>DELETE:files/{fileid}</pattern><description>Delete file attachment</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteFile</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><status value="404">The requested file could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:pages/{pageid}/files/{filename}</pattern><description>Delete file attachment</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteFile</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><status value="404">The requested file could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:files/{fileid}/{filename}</pattern><description>Delete file attachment</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteFile</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><status value="404">The requested file could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/files/{filename}/description</pattern><description>retrieves a file description</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFileDescription</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:files/{fileid}/description</pattern><description>retrieves a file description</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFileDescription</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>revision</name><valuetype>string?</valuetype><description>File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested file could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:pages/{pageid}/files/{filename}/description</pattern><description>Reset the file description</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutFileDescription</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested file could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>PUT:files/{fileid}/description</pattern><description>Update attachment description</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutFileDescription</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested file could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:files/{fileid}/description</pattern><description>Reset the file description</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutFileDescription</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested file could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/files/{filename}/description</pattern><description>Update attachment description</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutFileDescription</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects (only applies when {pageid} is present).</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested file could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>POST:files/{fileid}/index</pattern><description>re-index an attachment</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>IndexFile</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><status value="200">Request completed successfully</status><status value="403">MindTouch API key or Administrator access is required.</status><access>internal</access></feature><feature><pattern>GET:groups</pattern><description>Retrieve list of groups.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetGroups</method><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><param><name>sortby</name><valuetype>{id, name, role, service}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. default: No sorting</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>groupnamefilter</name><valuetype>string?</valuetype><description>Search for groups by name or part of a name</description></param><param><name>authprovider</name><valuetype>int?</valuetype><description>Return groups belonging to given authentication service id</description></param><status value="403">Read access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>GET:groups/{groupid}</pattern><description>Retrieve group information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetGroup</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{groupid}</name><valuetype>string</valuetype><description>either an integer group ID or "=" followed by a double uri-encoded group name</description></param><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><status value="403">Read access is required</status><status value="404">Requested group could not be found</status><access>public</access></feature><feature><pattern>GET:groups/{groupid}/users</pattern><description>Return a list of users in a group</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetGroupUsers</method><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><param><name>activatedfilter</name><valuetype>bool?</valuetype><description>Search for users by their active status</description></param><param><name>rolefilter</name><valuetype>string?</valuetype><description>Search for users by a role name</description></param><param><name>usernamefilter</name><valuetype>string?</valuetype><description>Search for users by name or part of a name</description></param><param><name>{groupid}</name><valuetype>string</valuetype><description>either an integer group ID or "=" followed by a double uri-encoded group name</description></param><param><name>sortby</name><valuetype>{id, username, nick, email, fullname, date.lastlogin, status, role, service}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. default: No sorting</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">Requested group could not be found</status><status value="403">Read access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>POST:groups</pattern><description>Add or modify a group</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostGroup</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>authpassword</name><valuetype>string?</valuetype><description>Password to use for verification with external authentication service</description></param><param><name>authusername</name><valuetype>string?</valuetype><description>Username to use for verification with external authentication service</description></param><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><status value="409">Group already exists</status><status value="404">Requested group could not be found</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>PUT:groups/{groupid}</pattern><description>Modify an existing group</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutGroup</method><param><name>{groupid}</name><valuetype>string</valuetype><description>either an integer group ID or "=" followed by a double uri-encoded group name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">Requested group could not be found</status><status value="200">Request completed successfully</status><status value="403">Administrator access is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>DELETE:groups/{groupid}</pattern><description>Remove a group</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteGroup</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{groupid}</name><valuetype>string</valuetype><description>either an integer group ID or "=" followed by a double uri-encoded group name</description></param><status value="404">Requested group could not be found</status><status value="403">Administrator access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>PUT:groups/{groupid}/users</pattern><description>Set the members for a group</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutGroupUsers</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{groupid}</name><valuetype>string</valuetype><description>either an integer group ID or "=" followed by a double uri-encoded group name</description></param><status value="400">Invalid input parameter or request body</status><status value="404">Requested group could not be found</status><status value="403">Administrator access is required</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>POST:groups/{groupid}/users</pattern><description>Add members to a group</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostGroupUsers</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{groupid}</name><valuetype>string</valuetype><description>either an integer group ID or "=" followed by a double uri-encoded group name</description></param><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><status value="404">Requested group could not be found</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>DELETE:groups/{groupid}/users/{userid}</pattern><description>Remove given member from a group</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteGroupUser</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{groupid}</name><valuetype>string</valuetype><description>either an integer group ID or "=" followed by a double uri-encoded group name</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><status value="403">Administrator access is required</status><status value="400">Invalid input parameter</status><status value="404">Requested group could not be found</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>GET:license</pattern><description>Retrieve server license. Requires ADMIN permission to retrieve private information, otherwise only the public information is obtained.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetLicense</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>format</name><valuetype>string?</valuetype><description>Response format for license aggreement (only availble for admins; one of "html", "xml"; default: "xml")</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>PUT:license</pattern><description>Update server license.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutLicense</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">ADMIN access is required to set or update a license</status><status value="400">Invalid license, input parameter, or request body</status><status value="200">The request completed successfully</status><access>internal</access></feature><feature><pattern>GET:site/nav/{pageid}/full</pattern><description>Retrieve &lt;div&gt; tags of the full navigation tree for the given page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetNavigationFull</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>type</name><valuetype>{compact, expandable}?</valuetype><description>Navigation type (default: compact).</description></param><param><name>format</name><valuetype>{debug, xml, html}?</valuetype><description>Output format (default: html).</description></param><param><name>width</name><valuetype>int?</valuetype><description>Max width for visible text</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="403">Browse access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>GET:site/nav/{pageid}/children</pattern><description>Retrieve &lt;div&gt; tags for the sub-pages of the given page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetNavigationChildren</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>type</name><valuetype>{compact, expandable}?</valuetype><description>Navigation type (default: compact).</description></param><param><name>format</name><valuetype>{debug, xml, html}?</valuetype><description>Output format (default: html).</description></param><param><name>width</name><valuetype>int?</valuetype><description>Max width for visible text</description></param><param><name>exclude</name><valuetype>int?</valuetype><description>Page to exclude from result set.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="403">Browse access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>GET:site/nav/{pageid}/children,siblings</pattern><description>Retrieve &lt;div&gt; tags for the sub-pages and sibling pages of the given page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetNavigationChildrenSiblings</method><param><name>width</name><valuetype>int?</valuetype><description>Max width for visible text</description></param><param><name>exclude</name><valuetype>int?</valuetype><description>Page to exclude from result set.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>format</name><valuetype>{debug, xml, html}?</valuetype><description>Output format (default: html).</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested page could not be found</status><status value="403">Browse access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/nav/{pageid}/siblings</pattern><description>Retrieve &lt;div&gt; tags for sibling pages of the given page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetNavigationSiblings</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>format</name><valuetype>{debug, xml, html}?</valuetype><description>Output format (default: html).</description></param><param><name>width</name><valuetype>int?</valuetype><description>Max width for visible text</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="403">Browse access to the page is required</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>GET:site/feed</pattern><description>Retrieve feed of site changes</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteChanges</method><param><name>filter</name><valuetype>string?</valuetype><description>use "new" to include only newly created pages in the feed (default: all)</description></param><param><name>namespace</name><valuetype>string?</valuetype><description>Filter results by namespace (default: all namespace)</description></param><param><name>language</name><valuetype>string?</valuetype><description>Filter results by language (default: all languages)</description></param><param><name>format</name><valuetype>{all, daily, raw, rawdaily}?</valuetype><description>Format for feed (default: daily)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Skipped changes (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Number of changes to retrieve (default: 100)</description></param><param><name>since</name><valuetype>string?</valuetype><description>Start date for changes.  Date is provided in 'yyyyMMddHHmmss' format (default: ignored).</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">Suscribe access to the page is required</status><access>public</access></feature><feature><pattern>GET:site/feed/new</pattern><description>Retrieve feed of new page creations</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteChanges</method><param><name>filter</name><valuetype>string?</valuetype><description>use "new" to include only newly created pages in the feed (default: all)</description></param><param><name>namespace</name><valuetype>string?</valuetype><description>Filter results by namespace (default: all namespace)</description></param><param><name>language</name><valuetype>string?</valuetype><description>Filter results by language (default: all languages)</description></param><param><name>format</name><valuetype>{all, daily, raw, rawdaily}?</valuetype><description>Format for feed (default: daily)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Skipped changes (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Number of changes to retrieve (default: 100)</description></param><param><name>since</name><valuetype>string?</valuetype><description>Start date for changes.  Date is provided in 'yyyyMMddHHmmss' format (default: ignored).</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">Suscribe access to the page is required</status><access>public</access></feature><feature><pattern>GET:site/activity</pattern><description>Retrieve report on site activities</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteActivities</method><param><name>since</name><valuetype>string?</valuetype><description>Start date for report.  Date is provided in 'yyyyMMddHHmmss' format (default: last 14 days).</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">Suscribe access to the page is required</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/feed</pattern><description>Retrieve feed of page changes</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageChanges</method><param><name>depth</name><valuetype>string?</valuetype><description>How deep into the sub-tree changes should be included. 0 for the current page only, 'infinity' for entire sub-tree (default: 0)</description></param><param><name>format</name><valuetype>{all, daily, raw, rawdaily}?</valuetype><description>Format for feed (default: daily)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Skipped changes (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Number of changes to retrieve (default: 100)</description></param><param><name>since</name><valuetype>string?</valuetype><description>Start date for changes.  Date is provided in 'yyyyMMddHHmmss' format (default: ignored).</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>timezone</name><valuetype>string?</valuetype><description>Optionally indicate a timezone so that the news feed displays the messages with the timestamp adjusted to the preferred timezone (e.g. -09:00, the default is empty)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>filter</name><valuetype>string?</valuetype><description>use "new" to include only newly created pages in the feed (default: all)</description></param><status value="403">Read/suscribe access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/feed/new</pattern><description>Retrieve feed of new page creations</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageChanges</method><param><name>depth</name><valuetype>string?</valuetype><description>How deep into the sub-tree changes should be included. 0 for the current page only, 'infinity' for entire sub-tree (default: 0)</description></param><param><name>format</name><valuetype>{all, daily, raw, rawdaily}?</valuetype><description>Format for feed (default: daily)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Skipped changes (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Number of changes to retrieve (default: 100)</description></param><param><name>since</name><valuetype>string?</valuetype><description>Start date for changes.  Date is provided in 'yyyyMMddHHmmss' format (default: ignored).</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>timezone</name><valuetype>string?</valuetype><description>Optionally indicate a timezone so that the news feed displays the messages with the timestamp adjusted to the preferred timezone (e.g. -09:00, the default is empty)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>filter</name><valuetype>string?</valuetype><description>use "new" to include only newly created pages in the feed (default: all)</description></param><status value="403">Read/suscribe access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>GET:users/{userid}/feed</pattern><description>Retrieve feed of user contributions</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetUserContributions</method><param><name>since</name><valuetype>string?</valuetype><description>Start date for changes.  Date is provided in 'yyyyMMddHHmmss' format (default: ignored).</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Skipped changes (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Number of changes to retrieve (default: 100)</description></param><param><name>format</name><valuetype>{all, daily, raw, rawdaily}?</valuetype><description>Format for feed (default: daily)</description></param><status value="404">Requested user could not be found</status><status value="403">Suscribe access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:users/{userid}/favorites/feed</pattern><description>DEPRECATED: Retrieve feed of user favorites changes</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetUserFavoritesChanges</method><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>since</name><valuetype>string?</valuetype><description>Start date for changes.  Date is provided in 'yyyyMMddHHmmss' format (default: ignored).</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>format</name><valuetype>{all, daily, raw, rawdaily}?</valuetype><description>Format for feed (default: daily)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Skipped changes (default: 0)</description></param><param><name>limit</name><valuetype>int?</valuetype><description>Number of changes to retrieve (default: 100)</description></param><status value="200">The request completed successfully</status><status value="403">Suscribe access to the page is required</status><status value="404">Requested user could not be found</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}</pattern><description>Retrieve aggregate page information including attachments</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPage</method><param><name>revision</name><valuetype>string?</valuetype><description>Page revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><param><name>format</name><valuetype>{html, xhtml}?</valuetype><description>Result format (default: html)</description></param><param><name>mode</name><valuetype>{edit, raw, view}</valuetype><description>render content for different uses; default is 'view'</description></param><param><name>include</name><valuetype>string?</valuetype><description>Extra elements to include (choice of "contents"; default: include nothing extra)</description></param><param><name>exclude</name><valuetype>string?</valuetype><description>Elements to exclude from response document (choice of "inbound", "outbound"; default: exclude nothing)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">Read access to the page is required</status><status value="404">Requested page could not be found</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/allowed</pattern><description>Filter a list of user ids based on access to the page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageAllowedUsers</method><param><name>filterdisabled</name><valuetype>bool?</valuetype><description>DEPRECATED: Will always filter disabled users, regardless of permissions</description></param><param><name>permissions</name><valuetype>string?</valuetype><description>A comma separated list of permissions that must be satisfied (e.g read, etc.). Defaults to read, if not provided</description></param><param><name>{pageid}</name><valuetype>int</valuetype><description>integer page ID</description></param><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/diff</pattern><description>Show changes between revisions</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageDiff</method><param><name>mode</name><valuetype>{edit, raw, view}?</valuetype><description>which rendering mode to use when diffing; default is 'edit'</description></param><param><name>diff</name><valuetype>{combined, all}?</valuetype><description>Result format; 'combined' shows changes to the page contents, 'all' shows in addition the before and after versions of the page with highlighted changes; default is 'combined'</description></param><param><name>revision</name><valuetype>string?</valuetype><description>Page revision to retrieve. 'head' by default will retrieve latest revision. Positive integer will retrieve specific revision</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>previous</name><valuetype>string?</valuetype><description>Previous page revision to retrieve. 'head' by default will retrieve latest revision. Positive integer will retrieve specific revision</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>format</name><valuetype>{html, xhtml}?</valuetype><description>Result format (default: html)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="404">Requested page could not be found</status><status value="403">Read access to the page is required</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/info</pattern><description>Retrieve page information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageInfo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/pdf</pattern><description>Export a page to PDF</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageExportPDF</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>showtoc</name><valuetype>bool</valuetype><description>flag to display a table of contents in the exported document</description></param><param><name>sytlesheet</name><valuetype>string</valuetype><description>name of custom stylesheet to apply (stored in site/properties with namespace 'mindtouch.prince.stylesheet#</description></param><param><name>format</name><valuetype>string</valuetype><description>format to export: pdf | html (default: pdf)</description></param><param><name>deep</name><valuetype>bool</valuetype><description>flag to export the requested page and all subpages (default: false)</description></param><status value="404">Requested page could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/links</pattern><description>Retrieve list of inbound or outbound page links</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageLinks</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>dir</name><valuetype>{from, to}</valuetype><description>links pointing to a page or from a page</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="403">Read access to the page is required</status><status value="404">Requested page could not be found</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/subpages</pattern><description>Retrieve list of sub-pages</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageSubpages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested page could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/aliases</pattern><description>Retrieve list of page aliases</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageAliases</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/revisions</pattern><description>Retrieve revision history of a given title</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageRevisions</method><param><name>revision</name><valuetype>int?</valuetype><description>Page revision to retrieve</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 50)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/files</pattern><description>Retrieves a list of files for a given page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageFiles</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">Requested page could not be found</status><status value="403">Read access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/files,subpages</pattern><description>Retrieves a list of files and subpages for a given page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageSubpagesAndFiles</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="404">Requested page could not be found</status><status value="403">Read access to the page is required</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/revert</pattern><description>Revert page to an earlier revision</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageRevert</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>fromrevision</name><valuetype>int</valuetype><description>Revision number of page that will become the new head revision</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">Update access to the page is required</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/copy</pattern><description>Copy page to a new location</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageCopy</method><param><name>children</name><valuetype>bool?</valuetype><description>Copy child pages? (default: false)</description></param><param><name>talkpages</name><valuetype>bool?</valuetype><description>Copy talk pages? (default: true)</description></param><param><name>attachments</name><valuetype>bool?</valuetype><description>Copy attachments? (default: true)</description></param><param><name>tags</name><valuetype>bool?</valuetype><description>Copy tags? (default: true)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>title</name><valuetype>string?</valuetype><description>Set the title of the page. (default: same as original title)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>to</name><valuetype>string</valuetype><description>new page location including the path and name of the page</description></param><status value="404">Requested page could not be found</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="409">Page move would conflict with an existing page</status><status value="403">Update access to the page is required</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/move</pattern><description>Move page to a new location</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageMove</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>parentid</name><valuetype>int?</valuetype><description>Relocate the page under a given parent page</description></param><param><name>name</name><valuetype>string?</valuetype><description>Move the page to the given name while keeping it under the same parent page</description></param><param><name>to</name><valuetype>string?</valuetype><description>new page location including the path and name of the page</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>title</name><valuetype>string?</valuetype><description>Set the title of the page. The name of a page is also modified unless it's provided</description></param><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="404">Requested page could not be found</status><status value="200">The request completed successfully</status><status value="409">Page move would conflict with an existing page</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/contents</pattern><description>Retrieve the contents of a page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageContents</method><param><name>pageid</name><valuetype>int?</valuetype><description>For template pages, use specified page ID as context for template invocation (default: none)</description></param><param><name>include</name><valuetype>bool?</valuetype><description>Treat page as an include (default: false)</description></param><param><name>section</name><valuetype>int?</valuetype><description>The section number (default: none)</description></param><param><name>format</name><valuetype>{html, xhtml}?</valuetype><description>Result format (default: html)</description></param><param><name>highlight</name><valuetype>string?</valuetype><description>Comma separated list of terms to highlight (default: empty)</description></param><param><name>mode</name><valuetype>{edit, raw, view}</valuetype><description>render content for different uses; default is 'view'</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>revision</name><valuetype>string?</valuetype><description>Page revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><param><name>relto</name><valuetype>int?</valuetype><description>Page used for path normalization (default: none)</description></param><param><name>reltopath</name><valuetype>string?</valuetype><description>Page used for path normalization. Ignored if relto parameter is defined. (default: none)</description></param><status value="203">Page contents could not be parsed in its native format and was returned in an alternative format instead</status><status value="404">Requested page could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/contents/explain</pattern><description>Explain how contents of a page are rendered.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageContents</method><param><name>pageid</name><valuetype>int?</valuetype><description>For template pages, use specified page ID as context for template invocation (default: none)</description></param><param><name>include</name><valuetype>bool?</valuetype><description>Treat page as an include (default: false)</description></param><param><name>section</name><valuetype>int?</valuetype><description>The section number (default: none)</description></param><param><name>format</name><valuetype>{html, xhtml}?</valuetype><description>Result format (default: html)</description></param><param><name>highlight</name><valuetype>string?</valuetype><description>Comma separated list of terms to highlight (default: empty)</description></param><param><name>mode</name><valuetype>{edit, raw, view}</valuetype><description>render content for different uses; default is 'view'</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>revision</name><valuetype>string?</valuetype><description>Page revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision</description></param><param><name>relto</name><valuetype>int?</valuetype><description>Page used for path normalization (default: none)</description></param><param><name>reltopath</name><valuetype>string?</valuetype><description>Page used for path normalization. Ignored if relto parameter is defined. (default: none)</description></param><status value="203">Page contents could not be parsed in its native format and was returned in an alternative format instead</status><status value="404">Requested page could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/contents</pattern><description>Update contents of a page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageContents</method><param><name>overwrite</name><valuetype>bool?</valuetype><description>New page revision is created when no changes are detected when overwrite is true (default: false)</description></param><param><name>reltopath</name><valuetype>string?</valuetype><description>Page used for path normalization. Ignored if relto parameter is defined. (default: none)</description></param><param><name>relto</name><valuetype>int?</valuetype><description>Page used for path normalization (default: none)</description></param><param><name>tidy</name><valuetype>{remove, convert}?</valuetype><description>Determines if invalid content is converted to text or removed (default: 'convert')</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>specifies condition under which to prevent the save; default is never</description></param><param><name>xpath</name><valuetype>string?</valuetype><description>identifies the portion of the page to update; this parameter is ignored if section is specified</description></param><param><name>section</name><valuetype>int?</valuetype><description>the section number.  If zero, append as a new section</description></param><param><name>title</name><valuetype>string?</valuetype><description>the display title (default: use existing title or determine from page path.)</description></param><param><name>language</name><valuetype>string?</valuetype><description>the page language (default: determine culture from parent)</description></param><param><name>comment</name><valuetype>string?</valuetype><description>the edit comment</description></param><param><name>edittime</name><valuetype>string</valuetype><description>the previous revision's edit timestamp (yyyyMMddHHmmss or yyyy-MM-ddTHH:mm:ssZ) or "now" to bypass concurrent edit check</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>restriction</name><valuetype>string?</valuetype><description>Optionally set the restriction of the page</description></param><param><name>importtime</name><valuetype>string?</valuetype><description>If this is an import, the edit timestamp of the imported content (yyyyMMddHHmmss or yyyy-MM-ddTHH:mm:ssZ)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/revisions</pattern><description>Performs operations such as hide/unhide for revisions of pages</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageRevisions</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>comment</name><valuetype>string?</valuetype><description>Reason for hiding revisions</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="200">The request completed successfully</status><status value="403">DELETE access is required to hide a revision and ADMIN access to unhide</status><status value="404">Requested page could not be found</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/index</pattern><description>re-index a page and it's attributes</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>IndexPage</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>internal</access></feature><feature><pattern>DELETE:pages/{pageid}</pattern><description>Deletes a page and optionally descendant pages by moving them to the archive</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeletePage</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>recursive</name><valuetype>bool?</valuetype><description>only delete page or delete page and descendants. Default: false</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">Requested page could not be found</status><status value="403">Update/delete access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages</pattern><description>Builds a site map starting from 'home' page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>startpage</name><valuetype>bool?</valuetype><description>For HTML sitemap, indicates if the start page should be included (default: true)</description></param><param><name>format</name><valuetype>{xml, html, google}?</valuetype><description>Result format (default: xml)</description></param><param><name>language</name><valuetype>string?</valuetype><description>Filter results by language (default: all languages)</description></param><status value="400">Invalid input parameter or request body</status><status value="403">Browse access to the page is required</status><status value="404">Requested page could not be found</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/tree</pattern><description>Builds a site map starting from a given page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>startpage</name><valuetype>bool?</valuetype><description>For HTML sitemap, indicates if the start page should be included (default: true)</description></param><param><name>format</name><valuetype>{xml, html, google}?</valuetype><description>Result format (default: xml)</description></param><param><name>language</name><valuetype>string?</valuetype><description>Filter results by language (default: all languages)</description></param><status value="400">Invalid input parameter or request body</status><status value="403">Browse access to the page is required</status><status value="404">Requested page could not be found</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/popular</pattern><description>Retrieves a list of popular pages.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPopularPages</method><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 50)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>language</name><valuetype>string?</valuetype><description>Filter results by language (default: all languages)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/export</pattern><description>Generates the information so that clients can stream down the exported page(s) in mtarc format</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostExportPageTree</method><param><name>pageid</name><valuetype>int</valuetype><description>The pageid for the page that you want to export</description></param><status value="200">The request completed successfully</status><status value="403">Only logged in users can calls this method</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/export/{token}/{filename}</pattern><description>Retrieve the mtarc tree export for the specific page using the token and providing an optional filename for the file to download.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetExportPageTree</method><param><name>recursive</name><valuetype>bool?</valuetype><description>Used to indicate if we export the full tree under the provided pageid</description></param><param><name>relto</name><valuetype>int?</valuetype><description>Export relative to page id</description></param><param><name>reltopath</name><valuetype>string?</valuetype><description>Export relative to uri path</description></param><param><name>dryrun</name><valuetype>bool?</valuetype><description>Used to indicate that a simulated run will be done. Default is false</description></param><param><name>token</name><valuetype>string</valuetype><description>A token that specifies the location of the page that we want to export</description></param><param><name>pageid</name><valuetype>int</valuetype><description>The page's id</description></param><status value="403">Only logged in users can calls this method</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/export/{token}</pattern><description>Retrieve the mtarc tree export for the specific page using the token</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetExportPageTree</method><param><name>recursive</name><valuetype>bool?</valuetype><description>Used to indicate if we export the full tree under the provided pageid</description></param><param><name>relto</name><valuetype>int?</valuetype><description>Export relative to page id</description></param><param><name>reltopath</name><valuetype>string?</valuetype><description>Export relative to uri path</description></param><param><name>dryrun</name><valuetype>bool?</valuetype><description>Used to indicate that a simulated run will be done. Default is false</description></param><param><name>token</name><valuetype>string</valuetype><description>A token that specifies the location of the page that we want to export</description></param><param><name>pageid</name><valuetype>int</valuetype><description>The page's id</description></param><status value="403">Only logged in users can calls this method</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/import</pattern><description>Import a tree of pages (mtarc format) into an instance at pageid as the root</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutImportPageTree</method><param><name>behavior</name><valuetype>string</valuetype><description>Specify the semantics of the call between blocking and non-blocking. Valid values are sync and async, default value is sync.</description></param><param><name>filename</name><valuetype>string</valuetype><description>The name of the file being uploaded</description></param><param><name>pageid</name><valuetype>int</valuetype><description>The page's id of the page that we want to use as the root of the import</description></param><status value="404">The provided pageid does not match an existent page</status><status value="500">Returned when the caching server fails to add, replace or fetch objects, or an unexpected error happens</status><status value="403">Returned when the user is not logged in, the size of the file exceeds the limit, or we could not establish a connection to the caching server</status><status value="200">The upload and import were successful (sync), or the upload and the request to import the content was successful (async)</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/import/status/{token}</pattern><description>Poll the status of an import identified by token into pageid</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetImportStatus</method><param><name>{token}</name><valuetype>string</valuetype><description>A token returned as part of the url that PUT:pages/{pageid}/import returns</description></param><param><name>{pageid}</name><valuetype>int</valuetype><description>A page's id</description></param><status value="200">The import's status is found and returned successfully</status><status value="404">The provided token does not match a requested import job</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/security</pattern><description>Retrieve page security info</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageSecurity</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="400">Invalid input parameter or request body</status><status value="404">Requested page could not be found</status><status value="200">The request completed successfully</status><status value="403">Browse access to the page is required</status><access>public</access></feature><feature><pattern>DELETE:pages/{pageid}/security</pattern><description>Reset page restricts and grants</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeletePageSecurity</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="404">The requested page could not be found</status><status value="200">The request completed successfully</status><status value="403">Change permissions access to the page is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/security</pattern><description>Set page security info</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutPageSecurity</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>cascade</name><valuetype>{none,delta,absolute}?</valuetype><description>none: Permissions are not cascaded to child pages; deltas: Changes between given page's security and proposed security cascaded to child nodes; absolute: Proposed security is set on child pages. Default: none</description></param><status value="403">Change permissions access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="404">Requested page could not be found</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/security</pattern><description>Modify page security by adding and removing grants</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageSecurity</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>cascade</name><valuetype>{none, delta}</valuetype><description>Apply proposed security to child pages. default: none</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">Change permissions access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/message/*//*</pattern><description>Post a custom page event into the pubsub bus (limited to 128KB)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageMessage</method><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="400">Invalid input parameter or request body</status><status value="403">A logged-in user is required</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/properties</pattern><description>Retrieve the properties associated with a page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertiesPages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>names</name><valuetype>string?</valuetype><description>Comma separated list of names of properties to return. The entire value should be URI encoded including the commas. Use '*' at the start or end of a name for wildcard matches. Default: all properties</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>contentcutoff</name><valuetype>int?</valuetype><description>Only show property content shorter than this number of bytes. Default: 2048</description></param><status value="404">Requested page could not be found</status><status value="403">READ access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:files/{fileid}/properties</pattern><description>Retrieve the properties associated with a file attachment</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertiesFiles</method><param><name>names</name><valuetype>string?</valuetype><description>Comma separated list of names of properties to return. The entire value should be URI encoded including the commas. Use '*' at the start or end of a name for wildcard matches. Default: all properties</description></param><param><name>contentcutoff</name><valuetype>int?</valuetype><description>Only show property content shorter than this number of bytes. Default: 2048</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">Requested file could not be found</status><status value="403">READ access is required</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:users/{userid}/properties</pattern><description>Retrieve the properties associated with a user</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertiesUsers</method><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>names</name><valuetype>string?</valuetype><description>Comma separated list of names of properties to return. The entire value should be URI encoded including the commas. Use '*' at the start or end of a name for wildcard matches. Default: all properties</description></param><param><name>contentcutoff</name><valuetype>int?</valuetype><description>Only show property content shorter than this number of bytes. Default: 2048</description></param><status value="404">Requested user could not be found</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">ADMIN access is required to access other user's properties</status><access>public</access></feature><feature><pattern>GET:site/properties</pattern><description>Retrieve the properties associated with the site</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertiesSite</method><param><name>contentcutoff</name><valuetype>int?</valuetype><description>Only show property content shorter than this number of bytes. Default: 2048</description></param><param><name>names</name><valuetype>string?</valuetype><description>Comma separated list of names of properties to return. The entire value should be URI encoded including the commas. Use '*' at the start or end of a name for wildcard matches. Default: all properties</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="403">ADMIN access is required</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter</status><access>public</access></feature><feature><pattern>GET:site/search/properties</pattern><description>Retrieve all pages with a specified property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPagesWithProperty</method><param><name>name</name><valuetype>string</valuetype><description>The name of the property to search for</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>verbose</name><valuetype>bool?</valuetype><description>Show verbose page output.  default: true</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/properties/{key}</pattern><description>Retrieve the content of a page property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertyPages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:pages/{pageid}/properties</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="400">Invalid input parameter or request body</status><status value="404">Requested page and/or property could not be found</status><status value="403">READ access is required</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:files/{fileid}/properties/{key}</pattern><description>Retrieve the content of an attachment property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertyFiles</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:files/{fileid}/properties</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">READ access is required</status><status value="404">Requested file and/or property could not be found</status><access>public</access></feature><feature><pattern>GET:users/{userid}/properties/{key}</pattern><description>Retrieve the content of a user property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertyUsers</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:users/{userid}/properties</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="400">Invalid input parameter or request body</status><status value="403">ADMIN access is required to access other user's properties</status><status value="200">The request completed successfully</status><status value="404">Requested user and/or property could not be found</status><access>public</access></feature><feature><pattern>GET:site/properties/{key}</pattern><description>Retrieve the content of a site property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertySite</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:site/properties</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested property could not be found</status><status value="403">ADMIN access is required</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/properties/{key}/info</pattern><description>Retrieve the metadata about a page property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertyContentsPages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>contentcutoff</name><valuetype>int?</valuetype><description>Only show property content shorter than this number of bytes. Default: 2048</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:pages/{pageid}/properties</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">READ access is required</status><status value="404">Requested page and/or property could not be found</status><access>public</access></feature><feature><pattern>GET:files/{fileid}/properties/{key}/info</pattern><description>Retrieve the metadata about an attachment property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertyContentsFiles</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:files/{fileid}/properties</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>contentcutoff</name><valuetype>int?</valuetype><description>Only show property content shorter than this number of bytes. Default: 2048</description></param><status value="404">Requested file and/or property could not be found</status><status value="403">READ access is required</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:users/{userid}/properties/{key}/info</pattern><description>Retrieve the metadata about a user property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertyContentsUsers</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>contentcutoff</name><valuetype>int?</valuetype><description>Only show property content shorter than this number of bytes. Default: 2048</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:users/{userid}/properties</description></param><status value="404">Requested user and/or property could not be found</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="403">ADMIN access is required to access other user's properties</status><access>public</access></feature><feature><pattern>GET:site/properties/{key}/info</pattern><description>Retrieve the metadata about a site property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetResourcePropertyContentsSite</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>contentcutoff</name><valuetype>int?</valuetype><description>Only show property content shorter than this number of bytes. Default: 2048</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:site/properties</description></param><status value="403">ADMIN access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested property could not be found</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/properties</pattern><description>Perform changes on multiple page properties</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertiesPages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="400">Invalid input parameter or request body</status><status value="404">Requested page could not be found</status><status value="403">UPDATE access is required</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>PUT:files/{fileid}/properties</pattern><description>Perform changes on multiple attachment properties</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertiesFiles</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="400">Invalid input parameter or request body</status><status value="403">UPDATE access is required</status><status value="200">The request completed successfully</status><status value="404">Requested file could not be found</status><access>public</access></feature><feature><pattern>PUT:users/{userid}/properties</pattern><description>Perform changes on multiple user properties</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertiesUsers</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="403">ADMIN access is required to access other user's properties</status><status value="404">Requested user could not be found</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>PUT:site/properties</pattern><description>Perform changes on multiple site properties</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertiesSite</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="403">ADMIN access is required</status><access>public</access></feature><feature><pattern>POST:pages/{pageid}/properties</pattern><description>Create a page property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostResourcePropertyPages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the creation; default is exists.</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested page could not be found</status><status value="403">UPDATE access is required</status><access>public</access></feature><feature><pattern>POST:files/{fileid}/properties</pattern><description>Create an attachment property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostResourcePropertyFiles</method><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the creation; default is exists.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="403">UPDATE access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested file could not be found</status><access>public</access></feature><feature><pattern>POST:users/{userid}/properties</pattern><description>Create a user property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostResourcePropertyUsers</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the creation; default is exists.</description></param><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="404">Requested user could not be found</status><status value="403">ADMIN access is required to access other user's properties</status><access>public</access></feature><feature><pattern>POST:site/properties</pattern><description>Create a site property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostResourcePropertySite</method><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the creation; default is exists.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">ADMIN access is required</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/properties/{key}</pattern><description>Update an existing page property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertyPages</method><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the update; default is modified.</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>etag</name><valuetype>string?</valuetype><description>Etag of the current version of the property. Can alternatively be provided via ETag header.</description></param><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:pages/{pageid}/properties</description></param><status value="404">Requested page and/or property could not be found</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="403">UPDATE access is required</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/files/{filename}/properties/{key}</pattern><description>Update an existing attachment property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertyFiles</method><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:files/{fileid}/properties</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the update; default is modified.</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>etag</name><valuetype>string?</valuetype><description>Etag of the current version of the property. Can alternatively be provided via ETag header.</description></param><status value="404">Requested file and/or property could not be found</status><status value="403">UPDATE access is required</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>PUT:files/{fileid}/properties/{key}</pattern><description>Update an existing attachment property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertyFiles</method><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:files/{fileid}/properties</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the update; default is modified.</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>etag</name><valuetype>string?</valuetype><description>Etag of the current version of the property. Can alternatively be provided via ETag header.</description></param><status value="404">Requested file and/or property could not be found</status><status value="403">UPDATE access is required</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>PUT:users/{userid}/properties/{key}</pattern><description>Update an existing user property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertyUsers</method><param><name>etag</name><valuetype>string?</valuetype><description>Etag of the current version of the property. Can alternatively be provided via ETag header.</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:users/{userid}/properties</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the update; default is modified.</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><status value="404">Requested user and/or property could not be found</status><status value="403">ADMIN access is required to access other user's properties</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>PUT:site/properties/{key}</pattern><description>Update an existing site property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutResourcePropertySite</method><param><name>abort</name><valuetype>{never, modified, exists}?</valuetype><description>Specifies condition under which to prevent the update; default is modified.</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:site/properties</description></param><param><name>etag</name><valuetype>string?</valuetype><description>Etag of the current version of the property. Can alternatively be provided via ETag header.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>description</name><valuetype>string?</valuetype><description>Description of property</description></param><status value="404">Requested property could not be found</status><status value="403">ADMIN access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:pages/{pageid}/properties/{key}</pattern><description>Remove a page property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteResourcePropertyPages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:pages/{pageid}/properties</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="400">Invalid input parameter or request body</status><status value="403">UPDATE access is required</status><status value="404">Requested page and/or property could not be found</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:files/{fileid}/properties/{key}</pattern><description>Remove an attachment property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteResourcePropertyFiles</method><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:files/{fileid}/properties</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><status value="404">Requested file and/or property could not be found</status><status value="403">UPDATE access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:users/{userid}/properties/{key}</pattern><description>Remove a user property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteResourcePropertyUsers</method><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:users/{userid}/properties</description></param><status value="404">Requested user and/or property could not be found</status><status value="403">ADMIN access is required to access other user's properties</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:site/properties/{key}</pattern><description>Remove a site property</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteResourcePropertySite</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>{key}</name><valuetype>string</valuetype><description>A unique identifier for a property that is obtained through GET:site/properties</description></param><status value="403">ADMIN access is required</status><status value="404">Requested property could not be found</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/ratings</pattern><description>Retrieve the page rating</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageRating</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><access>public</access></feature><feature><pattern>POST:pages/{pageid}/ratings</pattern><description>Rate the quality of a page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostPageRating</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>score</name><valuetype>int</valuetype><description>A '0' or '1' respectively indicating a poor or good rating. A value of '' will reset a rating.</description></param><status value="404">Requested page could not be found</status><status value="200">The request completed successfully</status><status value="403">READ access to the page is required</status><status value="400">Invalid input parameter</status><access>public</access></feature><feature><pattern>GET:site/roles</pattern><description>Retrieve list of defined roles</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteRoles</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/roles/{roleid}</pattern><description>Retrieve a role</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteRole</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{roleid}</name><valuetype>string</valuetype><description>either an integer role ID or "=" followed by a double uri-encoded role name</description></param><status value="200">The request completed successfully</status><status value="404">Requested role could not be found</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>PUT:site/roles/{roleid}</pattern><description>Modify or add a role</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutSiteRole</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{roleid}</name><valuetype>string</valuetype><description>either an integer role ID or "=" followed by a double uri-encoded role name</description></param><status value="404">Requested role could not be found</status><status value="200">The request completed successfully</status><status value="403">Administrator access is required</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:site/operations</pattern><description>Retrieve all known security operations</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteOperations</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:pages/{pageid}/tags</pattern><description>Retrieve the tags on a page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetPageTags</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="403">Read access to the page is required</status><status value="404">The requested page could not be found</status><access>public</access></feature><feature><pattern>PUT:pages/{pageid}/tags</pattern><description>Sets the tags on a page.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>SetPageTags</method><param><name>redirects</name><valuetype>int?</valuetype><description>If zero, do not follow page redirects.</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>either an integer page ID, "home", or "=" followed by a double uri-encoded page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">The requested page could not be found</status><status value="403">Update access to the page is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/tags</pattern><description>Retrieve all tags</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetTags</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>q</name><valuetype>string?</valuetype><description>partial tag name to match (ex: tagprefix) (default none)</description></param><param><name>pages</name><valuetype>bool?</valuetype><description>show pages with each tag (default: false)</description></param><param><name>to</name><valuetype>string?</valuetype><description>end date for type=date (ex: 2008-12-30) (default: now + 30 days)</description></param><param><name>from</name><valuetype>string?</valuetype><description>start date for type=date (ex: 2008-01-30) (default: now)</description></param><param><name>type</name><valuetype>string?</valuetype><description>type of the tag (text | date | user | define) (default: all types)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">Read access to the page is required</status><status value="404">The requested page could not be found</status><access>public</access></feature><feature><pattern>GET:site/tags/{tagid}</pattern><description>Retrieve pages with tag</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetTaggedPages</method><param><name>{tagid}</name><valuetype>string</valuetype><description>either an integer tag ID or "=" followed by a double uri-encoded tag name</description></param><param><name>language</name><valuetype>string?</valuetype><description>filter pages by language (default: all languages)</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="400">Invalid input parameter or request body</status><status value="404">The requested page could not be found</status><status value="200">The request completed successfully</status><status value="403">Read access to the page is required</status><access>public</access></feature><feature><pattern>GET:archive</pattern><description>Retrieves a summary of available archive information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchive</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>GET:archive/files</pattern><description>Retrieves file info for all deleted files</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchiveFiles</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>GET:archive/files/{fileid}/{filename}</pattern><description>Retrieve file attachment content</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchiveFile</method><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="404">Requested file could not be found in the archive</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>GET:archive/files/{fileid}</pattern><description>Retrieves file content for a deleted file</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchiveFile</method><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>{filename}</name><valuetype>string</valuetype><description>"=" followed by a double uri-encoded file name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="404">Requested file could not be found in the archive</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>GET:archive/files/{fileid}/info</pattern><description>Retrieves file info for a deleted file</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchiveFileInfo</method><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">Administrator access is required</status><status value="200">The request completed successfully</status><status value="404">Requested file could not be found in the archive</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>DELETE:archive/files/{fileid}</pattern><description>Remove a file from the archive (wipe)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteArchiveFile</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><status value="404">Requested file could not be found in the archive</status><status value="403">Administrator access is required</status><status value="400">Invalid input parameter or request body</status><status value="200">Request completed successfully</status><access>public</access></feature><feature><pattern>DELETE:archive/files</pattern><description>Removes all files from the archive (wipe)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteArchiveFiles</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>POST:archive/files/restore/{fileid}</pattern><description>Restores a deleted file back to its page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostArchiveFilesRestore</method><param><name>to</name><valuetype>string?</valuetype><description>Optional restore-to page to override a removed file's original parent id</description></param><param><name>{fileid}</name><valuetype>int</valuetype><description>identifies a file by ID</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">Administrator access is required</status><status value="200">The request completed successfully</status><status value="404">Requested file could not be found in the archive</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:archive/pages</pattern><description>Retrieve the pages that can be potentially restored from deletion.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchivePages</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><param><name>title</name><valuetype>string?</valuetype><description>Show deleted pages matching the given title. (default: all pages)</description></param><status value="200">The request completed successfully</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>GET:archive/pages/{pageid}</pattern><description>Retrieve basic page information for the deleted page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchivePagesInfo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>An integer page ID of a deleted page</description></param><status value="200">The request completed successfully</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>GET:archive/pages/{pageid}/info</pattern><description>Retrieve basic page information for the deleted page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchivePagesInfo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>An integer page ID of a deleted page</description></param><status value="200">The request completed successfully</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>GET:archive/pages/{pageid}/subpages</pattern><description>Retrieve the child pages that were deleted as well from deleting the given page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchivePageSubpages</method><param><name>{pageid}</name><valuetype>string</valuetype><description>An integer page ID of a deleted page</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="403">Administrator access is required</status><access>public</access></feature><feature><pattern>GET:archive/pages/{pageid}/contents</pattern><description>Retrieve the contents of a deleted page for previewing</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetArchivePageContents</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{pageid}</name><valuetype>string</valuetype><description>An integer page ID of a deleted page</description></param><status value="403">Administrator access is required</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:archive/pages/{pageid}/restore</pattern><description>Restore all revisions of a given page</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostArchivePagesPageIdRestore</method><param><name>{pageid}</name><valuetype>int</valuetype><description>An integer page ID from GET: archive/pages</description></param><param><name>reason</name><valuetype>string?</valuetype><description>Reason for reverting</description></param><param><name>to</name><valuetype>string</valuetype><description>new page title</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="409">A title with the same path already exists. To restoring to a different path with '?to='</status><status value="404">Unable to find the page to delete</status><status value="403">Administrator access is required</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/services</pattern><description>Retrieve list of services.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetServices</method><param><name>sortby</name><valuetype>{description, type, init, sid, uri}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. default: No sorting</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><param><name>type</name><valuetype>{auth, ext}?</valuetype><description>Return only these types of services. Default: Return all</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/services/{id}</pattern><description>Retrieve service.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetServiceById</method><param><name>{id}</name><valuetype>string</valuetype><description>identifies a service by ID or ={namespace}</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="404">Requested service could not be found</status><status value="403">MindTouch API key or Administrator access is required.</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>*:site/services/{id}/proxy//*</pattern><description>Proxy requets to a service.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>ProxyToService</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{id}</name><valuetype>string</valuetype><description>identifies a service by ID or ={namespace}</description></param><status value="400">Invalid input parameter or request body</status><status value="404">Requested service could not be found</status><status value="403">MindTouch API key or Administrator access is required.</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>POST:site/services/{id}</pattern><description>Restart a service (backwards compatibility)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostServicesId</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{id}</name><valuetype>int</valuetype><description>identifies a service by ID</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested service could not be found</status><access>internal</access></feature><feature><pattern>PUT:site/services/{id}</pattern><description>Update a service</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostServicesId</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{id}</name><valuetype>int</valuetype><description>identifies a service by ID</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested service could not be found</status><access>internal</access></feature><feature><pattern>POST:site/services</pattern><description>Add a service (backward compatibility: empty body will restart all services)</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostServices</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="200">The request completed successfully</status><access>internal</access></feature><feature><pattern>DELETE:site/services/{id}</pattern><description>Delete a service</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteSiteService</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="403">MindTouch API key or Administrator access is required.</status><access>internal</access></feature><feature><pattern>POST:site/services/{id}/start</pattern><description>Start or restart a service</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostServiceIdStart</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="200">The request completed successfully</status><access>internal</access></feature><feature><pattern>POST:site/services/{id}/stop</pattern><description>Stop a service</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostServiceIdStop</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="200">The request completed successfully</status><access>internal</access></feature><feature><pattern>GET:site/status</pattern><description>Get mindtouch instance status information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteStatus</method><status value="200">The request completed successfully</status><status value="403">User must be logged in</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:site/functions</pattern><description>Get list of available extensions</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteFunctions</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>format</name><valuetype>{html, body, xml}?</valuetype><description>output format (default: html)</description></param><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="403">User must be logged in</status><access>public</access></feature><feature><pattern>GET:site/localization</pattern><description>Retrieve a resource string localized for the current user, or provided culture</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetLocalizedString</method><param><name>resource</name><valuetype>string</valuetype><description>resource name to retrieve</description></param><param><name>lang</name><valuetype>string?</valuetype><description>Optional language code to use for resource localization</description></param><status value="404">Could not find requested resource</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:site/settings</pattern><description>Retrieve all configuration settings</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteSettings</method><param><name>include</name><valuetype>string</valuetype><description>Optional parameter used to include anonymous user and license information (possible values: anonymous, license). By default we do not include them.</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">MindTouch API key or Administrator access is required.</status><status value="200">The request completed successfully</status><access>internal</access></feature><feature><pattern>PUT:site/settings</pattern><description>Set all configuration settings</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutSiteSettings</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="403">MindTouch API key or Administrator access is required.</status><access>internal</access></feature><feature><pattern>POST:site/export</pattern><description>Generates export information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>SiteExport</method><param><name>relto</name><valuetype>int?</valuetype><description>Page used for path normalization (default:  home page)</description></param><param><name>reltopath</name><valuetype>string?</valuetype><description>Page used for path normalization.  Ignored if relto parameter is defined.</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>POST:site/import</pattern><description>Generates import information</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>SiteImport</method><param><name>reltopath</name><valuetype>string?</valuetype><description>Page used for path normalization.  Ignored if relto parameter is defined.</description></param><param><name>relto</name><valuetype>int?</valuetype><description>Page used for path normalization (default: home page)</description></param><param><name>forceoverwrite</name><valuetype>bool?</valuetype><description>Force overwrite of destination, even if import content is older.</description></param><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:site/logo</pattern><description>Retrieve the site logo image</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteLogo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>default</name><valuetype>string?</valuetype><description>Absolute uri for default image</description></param><access>public</access></feature><feature><pattern>GET:site/logo.png</pattern><description>Retrieve the site logo image</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetSiteLogo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>default</name><valuetype>string?</valuetype><description>Absolute uri for default image</description></param><access>public</access></feature><feature><pattern>PUT:site/logo.png</pattern><description>Save a new site logo image</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutSiteLogo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><access>internal</access></feature><feature><pattern>PUT:site/logo</pattern><description>Save a new site logo image</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutSiteLogo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><access>internal</access></feature><feature><pattern>DELETE:site/logo</pattern><description>Remove the site logo</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteSiteLogo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><access>internal</access></feature><feature><pattern>DELETE:site/logo.png</pattern><description>Remove the site logo</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteSiteLogo</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><access>internal</access></feature><feature><pattern>POST:site/feedback</pattern><description>Logged in users can submit feedback to a site owner unless a feedback email is defined.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostFeedback</method><status value="400">The required elements were not provided ("email subject and body not provided")</status><status value="200">The request completed successfully</status><status value="403">The user must be logged in to be able to submit feedback</status><access>public</access></feature><feature><pattern>POST:users/authenticate</pattern><description>Authenticate a user given http header Credentials or an auth token. When using external authentication, this will automatically create an account and synchronize groups. Response status 200 implies valid credentials and contains a new auth token.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostUserAuth</method><param><name>callback</name><valuetype>string?</valuetype><description>If specified, return response as a jsonp call using the provided callback.</description></param><param><name>ssotoken</name><valuetype>string?</valuetype><description>Token from remote auth service to be used for internal SSO authentication.</description></param><param><name>authprovider</name><valuetype>int?</valuetype><description>Identifier for the external service to use for authentication.</description></param><param><name>redirect</name><valuetype>uri?</valuetype><description>Redirect to the given URI upon authentication</description></param><status value="409">Username conflicts with an existing username</status><status value="403">Login access is required</status><status value="200">The request completed successfully</status><status value="401">Authentication failed</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:users/authenticate</pattern><description>Authenticate a user given http header Credentials or an auth token. Response status 200 implies valid credentials and contains a new auth token.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostUserAuth</method><param><name>callback</name><valuetype>string?</valuetype><description>If specified, return response as a jsonp call using the provided callback.</description></param><param><name>ssotoken</name><valuetype>string?</valuetype><description>Token from remote auth service to be used for internal SSO authentication.</description></param><param><name>authprovider</name><valuetype>int?</valuetype><description>Identifier for the external service to use for authentication.</description></param><param><name>redirect</name><valuetype>uri?</valuetype><description>Redirect to the given URI upon authentication</description></param><status value="409">Username conflicts with an existing username</status><status value="403">Login access is required</status><status value="200">The request completed successfully</status><status value="401">Authentication failed</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:users</pattern><description>Retrieve list of users.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetUsers</method><param><name>rolefilter</name><valuetype>string?</valuetype><description>Search for users by a role name</description></param><param><name>authprovider</name><valuetype>int?</valuetype><description>Return users belonging to given authentication service id</description></param><param><name>usernameemailfilter</name><valuetype>string?</valuetype><description>Search for users by name and email or part of a name and email</description></param><param><name>fullnamefilter</name><valuetype>string?</valuetype><description>Search for users full name starting with supplied text</description></param><param><name>usernamefilter</name><valuetype>string?</valuetype><description>Search for users name starting with supplied text</description></param><param><name>verbose</name><valuetype>bool?</valuetype><description>Return detailed user information. (default: true)</description></param><param><name>sortby</name><valuetype>{id, username, nick, email, fullname, date.lastlogin, status, role, service, date.created}?</valuetype><description>Sort field. Prefix value with '-' to sort descending. default: No sorting</description></param><param><name>offset</name><valuetype>int?</valuetype><description>Number of items to skip. Must be a positive number or 0 to not skip any. (default: 0)</description></param><param><name>limit</name><valuetype>string?</valuetype><description>Maximum number of items to retrieve. Must be a positive number or 'all' to retrieve all items. (default: 100)</description></param><param><name>seatfilter</name><valuetype>string?</valuetype><description>Search for users with or without seats (one of "seated", "unseated", or "recommended"; default: none)</description></param><param><name>activatedfilter</name><valuetype>bool?</valuetype><description>Search for users by their active status</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="403">Read access is required</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:users/{userid}</pattern><description>Retrieve information about a user.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetUser</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>Either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>exclude</name><valuetype>string?</valuetype><description>Elements to exclude from response document (choice of "groups", "properties"; default: exclude nothing)</description></param><status value="403">Read access is required</status><status value="200">The request completed successfully</status><status value="400">Invalid input parameter or request body</status><status value="404">Requested user could not be found</status><access>public</access></feature><feature><pattern>POST:users</pattern><description>Add or modify a user</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostUser</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>authpassword</name><valuetype>string?</valuetype><description>Password to use for verification with external authentication service</description></param><param><name>authusername</name><valuetype>string?</valuetype><description>Username to use for verification with external authentication service</description></param><param><name>accountpassword</name><valuetype>string?</valuetype><description>Account password to set (default: do not set/change password)</description></param><status value="400">Invalid input parameter or request body</status><status value="409">Username conflicts with an existing username</status><status value="200">The request completed successfully</status><status value="403">Administrator access, apikey, or account owner is required</status><status value="404">Requested user could not be found</status><access>public</access></feature><feature><pattern>PUT:users/{userid}</pattern><description>Modify an existing user</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutUser</method><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>authpassword</name><valuetype>string?</valuetype><description>Password to use for verification with external authentication service</description></param><param><name>authusername</name><valuetype>string?</valuetype><description>Username to use for verification with external authentication service</description></param><status value="409">Username conflicts with an existing username</status><status value="403">Administrator access or account owner is required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><status value="404">Requested user could not be found</status><access>public</access></feature><feature><pattern>POST:users/{userid}/allowed</pattern><description>Check one or more resources if given operation is allowed.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostUsersAllowed</method><param><name>operations</name><valuetype>string?</valuetype><description>Comma separated list of operations to verify</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>verbose</name><valuetype>bool?</valuetype><description>Return verbose information on permitted pages (default: true</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>invert</name><valuetype>bool?</valuetype><description>Return filtered instead of allowed pages. Sets verbose to false (default: false</description></param><param><name>mask</name><valuetype>long?</valuetype><description>Permission bit mask required for the pages</description></param><status value="400">Invalid input parameter or request body</status><status value="404">Requested user could not be found</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>PUT:users/{userid}/seat</pattern><description>Give a user a license seat.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutUserSeat</method><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><status value="404">Requested user could not be found</status><status value="403">Administrator access required</status><status value="200">The request completed successfully</status><status value="409">User cannot be given a seat or seats depleted</status><access>internal</access></feature><feature><pattern>DELETE:users/{userid}/seat</pattern><description>Remove a license seat from a user.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>DeleteUserSeat</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><status value="404">Requested user could not be found</status><status value="403">Administrator access required</status><status value="400">Invalid input parameter or request body</status><status value="200">The request completed successfully</status><access>internal</access></feature><feature><pattern>PUT:users/{userid}/password</pattern><description>Set password for a given user.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PutPasswordChange</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>currentpassword</name><valuetype>string?</valuetype><description>Current password needed when changing your own password (without admin rights)</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><param><name>altpassword</name><valuetype>bool?</valuetype><description>If true, the given password sets a secondary password that can be used for login. The main password is not overwritten. (default: false)</description></param><status value="403">Administrator access or account owner is required</status><status value="200">The request completed successfully</status><status value="404">Requested user could not be found</status><status value="400">Invalid input parameter or request body</status><access>public</access></feature><feature><pattern>GET:users/{userid}/favorites</pattern><description>DEPRECATED: Retrieves a list of favorite pages for a user.</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetFavoritePagesForUser</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><status value="403">BROWSE access is required</status><status value="200">The request completed successfully</status><status value="404">Requested user could not be found</status><access>public</access></feature><feature><pattern>GET:users/{userid}/metrics</pattern><description>Retrieve usage metrics for a user</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetMetricsForUser</method><param><name>authenticate</name><valuetype>bool?</valuetype><description>Force authentication for request (default: false)</description></param><param><name>{userid}</name><valuetype>string</valuetype><description>either an integer user ID, "current", or "=" followed by a double uri-encoded user name</description></param><status value="404">Requested user could not be found</status><status value="200">The request completed successfully</status><access>public</access></feature><feature><pattern>GET:</pattern><description>Retrieve extension description</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetExtensionLibrary</method><access>public</access></feature><feature><pattern>POST:{function}</pattern><description>Invoke extension function</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>PostExtensionFunction</method><access>public</access></feature><feature><pattern>GET:$files/{name}</pattern><description>Retrieve file contents</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetLibraryFiles</method><access>public</access></feature><feature><pattern>HEAD:$files/{name}</pattern><description>Retrieve file headers</description><info>http://developer.mindtouch.com/en/ref/MindTouch_API</info><method>GetLibraryFiles</method><access>public</access></feature><feature><pattern>GET:@config</pattern><description>Retrieve service configuration</description><info>http://developer.mindtouch.com/Dream/Reference/General/Generic_Features</info><method>GetConfig</method><access>private</access></feature><feature><pattern>PUT:@config</pattern><description>Initialize service</description><info>http://developer.mindtouch.com/Dream/Reference/General/Generic_Features</info><method>PutConfig</method><access>private</access></feature><feature><pattern>DELETE:@config</pattern><description>Deinitialize service</description><info>http://developer.mindtouch.com/Dream/Reference/General/Generic_Features</info><method>DeleteConfig</method><access>private</access></feature><feature><pattern>GET:@blueprint</pattern><description>Retrieve service blueprint</description><info>http://developer.mindtouch.com/Dream/Reference/General/Generic_Features</info><method>GetServiceBlueprint</method><access>public</access></feature><feature><pattern>GET:@about</pattern><description>Retrieve service description</description><info>http://developer.mindtouch.com/Dream/Reference/General/Generic_Features</info><method>GetServiceInfo</method><access>public</access></feature><feature><pattern>DELETE:</pattern><description>Stop service</description><info>http://developer.mindtouch.com/Dream/Reference/General/Generic_Features</info><method>DeleteService</method><status value="200">Request completed successfully</status><status value="403">Insufficient permission</status><access>private</access></feature><feature><pattern>POST:@grants</pattern><description>Adds a grant to this service for accessing another service.</description><info>http://developer.mindtouch.com/Dream/Reference/General/Generic_Features</info><method>PostGrant</method><access>internal</access></feature></features></blueprint>
