pages/{pageid}/security (DELETE)
Overview
Reset page restricts and grants
- REST Method: DELETE
- Method Access: public
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.