pages/{pageid}/security (DELETE)

Overview

Reset page restricts and grants

Uri Parameters

Name Type Description
pageid string either an integer page ID, "home", or "=" followed by a double uri-encoded page path

Query Parameters

Name Type Description
authenticate bool? Force authentication for request (default: false)
redirects int? If zero, do not follow page redirects.

Return Codes

Name Value Description
OK 200 The request completed successfully
Bad Request 400 Invalid input parameter or request body
Forbidden 403 Change permissions access to the page is required
Not Found 404 The requested page could not be found

Message Format

None

Implementation Notes

The page restriction and all grants on the page are removed. Existing descendant pages are unaffected, but new descendant pages will inherit the updated security settings.

C# Code Sample: Remove Security Setting

The following code example resets the security settings on the home page:

Sample Code

Plug p = Plug.New("http://deki-hayes/@api/deki");
p.At("users", "authenticate").WithCredentials("admin", "password").Get();
p.At("pages", "home", "security").Delete();

Implementation notes 

Add notes about requirements or config values

Curl Code Sample: Remove Page Security Settings

The following command removes all security settings from page "foo":

Sample Code

curl -u admin:password -X DELETE -i http://mindtouch.address/@api/deki/pages/=foo/security

Implementation notes 

curl flags

-u
Provides external user authentication.
-X
Specifies the HTTP request method.
-i
Outputs the HTTP response headers. Useful for debugging.

Permissions

ADMIN permission is required to execute above command.