Levitating/Telodendria
1
0
Fork 0
forked from Telodendria/Telodendria
Code Pull requests Activity

Fix admin endpoint names in documentation

Browse source
This commit is contained in:
Jordan Bancino 2023-11-08 11:21:20 -05:00
parent edee1288d8
commit db4ae0408c
4 changed files with 10 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
docs/user/admin/config.md
View file

@ -8,7 +8,7 @@ update the configuration described in that document.
## API Endpoints ## API Endpoints
### **GET** `/_telodendria/admin/config` ### **GET** `/_telodendria/admin/v1/config`
Retrieve the current configuration. Retrieve the current configuration.
@ -20,7 +20,7 @@ Retrieve the current configuration.
|---------------|-------------| |---------------|-------------|
| 200 | The current configuration was successfully retrieved.| | 200 | The current configuration was successfully retrieved.|
### **POST** `/_telodendria/admin/config` ### **POST** `/_telodendria/admin/v1/config`
Installs a new configuration. This endpoint validates the request body, Installs a new configuration. This endpoint validates the request body,
ensuring it is a proper configuration, then it replaces the existing ensuring it is a proper configuration, then it replaces the existing
@ -40,7 +40,7 @@ configuration with the new one.
|-------|------|-------------| |-------|------|-------------|
| `restart_required` | `Boolean` | Whether or not the process needs to be restarted to finish applying the configuration. If this is `true`, then the restart endpoint should be used at a convenient time to apply the configuration. | `restart_required` | `Boolean` | Whether or not the process needs to be restarted to finish applying the configuration. If this is `true`, then the restart endpoint should be used at a convenient time to apply the configuration.
### **PUT** `/_telodendria/admin/config` ### **PUT** `/_telodendria/admin/v1/config`
Update the currently installed configuration instead of completely replacing it. This endpoint Update the currently installed configuration instead of completely replacing it. This endpoint
validates the request body, merges it on top of the current configuration, validates the resulting validates the request body, merges it on top of the current configuration, validates the resulting

8
docs/user/admin/privileges.md
View file

@ -41,7 +41,7 @@ this privilege level.
The following API endpoints are implemented for managing privileges. The following API endpoints are implemented for managing privileges.
### **GET** `/_telodendria/admin/privileges/[localpart]` ### **GET** `/_telodendria/admin/v1/privileges/[localpart]`
Retrieve the permissions for a user. If the localpart is omitted, then Retrieve the permissions for a user. If the localpart is omitted, then
retrieve the privileges for the user that owns the access token being retrieve the privileges for the user that owns the access token being
@ -62,7 +62,7 @@ used. Note that the owner of the access token must have the
|-------|------|-------------| |-------|------|-------------|
| `privileges` | `Array` | An array of privileges, as described above. The privileges are encoded as JSON strings.| | `privileges` | `Array` | An array of privileges, as described above. The privileges are encoded as JSON strings.|
### **POST** `/_telodendria/admin/privileges/[localpart]` ### **POST** `/_telodendria/admin/v1/privileges/[localpart]`
Update the privileges of a local user by replacing the privileges array Update the privileges of a local user by replacing the privileges array
with the one specified in the request. Like the **GET** version of this with the one specified in the request. Like the **GET** version of this
@ -89,7 +89,7 @@ owns the access token.
|-------|------|-------------| |-------|------|-------------|
| `privileges` | `Array` | An array of privileges, as described above. The privileges are encoded as JSON strings.| | `privileges` | `Array` | An array of privileges, as described above. The privileges are encoded as JSON strings.|
### **PUT** `/_telodendria/admin/privileges/[localpart]` ### **PUT** `/_telodendria/admin/v1/privileges/[localpart]`
Update the privileges of a local user by adding the privileges Update the privileges of a local user by adding the privileges
specified in the request to the users existing privileges. specified in the request to the users existing privileges.
@ -114,7 +114,7 @@ specified in the request to the users existing privileges.
|-------|------|-------------| |-------|------|-------------|
| `privileges` | `Array` | An array of privileges, as described above. The privileges are encoded as JSON strings.| | `privileges` | `Array` | An array of privileges, as described above. The privileges are encoded as JSON strings.|
### **DELETE** `/_telodendria/admin/privileges/[localpart]` ### **DELETE** `/_telodendria/admin/v1/privileges/[localpart]`
Update the privileges of a local user by removing the privileges Update the privileges of a local user by removing the privileges
specified in the request from the user's existing privileges. specified in the request from the user's existing privileges.

4
docs/user/admin/proc.md
View file

@ -5,7 +5,7 @@ administrator to manage the Telodendria process itself.
## API Endpoints ## API Endpoints
### **POST** `/_telodendria/admin/restart` ### **POST** `/_telodendria/admin/v1/restart`
Restart the Telodendria daemon cleanly. This endpoint will respond Restart the Telodendria daemon cleanly. This endpoint will respond
immediately after signaling to the daemon that it should be restarted immediately after signaling to the daemon that it should be restarted
@ -26,7 +26,7 @@ starts over.
On success, this endpoint simply returns an empty JSON object. On success, this endpoint simply returns an empty JSON object.
### **POST** `/_telodendria/admin/shutdown` ### **POST** `/_telodendria/admin/v1/shutdown`
Shut down the Telodendria process cleanly. This endpoint will respond Shut down the Telodendria process cleanly. This endpoint will respond
immediately after signalling to the daemon that it should be shut immediately after signalling to the daemon that it should be shut

2
docs/user/admin/stats.md
View file

@ -5,7 +5,7 @@ information about how the server process is performing.
## API Endpoints ## API Endpoints
### **GET** `/_telodendria/admin/stats` ### **GET** `/_telodendria/admin/v1/stats`
Retrieve basic statistics about the currently running Telodendria Retrieve basic statistics about the currently running Telodendria
process. process.