JAMES-2138 Documenting group feature on the website

Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/55f476a6
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/55f476a6
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/55f476a6

Branch: refs/heads/master
Commit: 55f476a68e3b709d00a4b2909781941474c87500
Parents: dc2ad6d
Author: benwa <btell...@linagora.com>
Authored: Wed Sep 6 14:09:36 2017 +0700
Committer: benwa <btell...@linagora.com>
Committed: Sat Sep 9 10:46:41 2017 +0700

----------------------------------------------------------------------
 src/site/markdown/server/manage-webadmin.md | 75 ++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/james-project/blob/55f476a6/src/site/markdown/server/manage-webadmin.md
----------------------------------------------------------------------
diff --git a/src/site/markdown/server/manage-webadmin.md 
b/src/site/markdown/server/manage-webadmin.md
index 2f9a2f6..5fb5d2c 100644
--- a/src/site/markdown/server/manage-webadmin.md
+++ b/src/site/markdown/server/manage-webadmin.md
@@ -425,3 +425,78 @@ Note that several calls to this endpoint will be run in a 
sequential pattern.
 
 If the server restarts during the migration, the migration is silently aborted.
 
+## Creating address group
+
+You can use **webadmin** to define address groups.
+
+When a specific email is sent to the group mail address, every group member 
will receive it.
+
+This feature uses [Recipients rewrite 
table](/server/config-recipientrewritetable.html) and requires
+the [RecipientRewriteTable 
mailet](https://github.com/apache/james-project/blob/master/server/mailet/mailets/src/main/java/org/apache/james/transport/mailets/RecipientRewriteTable.java)
+to be configured.
+
+### Listing groups
+
+```
+curl -XGET http://ip:port/address/groups
+```
+
+Will return the groups as a list of JSON Strings representing mail addresses. 
For instance:
+
+```
+["gro...@domain.com", "gro...@domain.com"]
+```
+
+Response codes:
+
+ - 200: Success
+ - 500: Internal error
+
+### Listing members of a group
+
+```
+curl -XGET http://ip:port/address/groups/gr...@domain.com
+```
+
+Will return the group members as a list of JSON Strings representing mail 
addresses. For instance:
+
+```
+["memb...@domain.com", "memb...@domain.com"]
+```
+
+Response codes:
+
+ - 200: Success
+ - 400: Group structure is not valid
+ - 404: The group does not exist
+ - 500: Internal error
+
+### Adding a group member
+
+```
+curl -XPUT http://ip:port/address/groups/gr...@domain.com/mem...@domain.com
+```
+
+Will add mem...@domain.com to gr...@domain.com, creating the group if needed
+
+Response codes:
+
+ - 200: Success
+ - 400: Group structure or member is not valid
+ - 403: Server does not own the requested domain
+ - 409: Requested group address is already used for another purpose
+ - 500: Internal error
+
+### Removing a group member
+
+```
+curl -XDELETE http://ip:port/address/groups/gr...@domain.com/mem...@domain.com
+```
+
+Will remove mem...@domain.com from gr...@domain.com, removing the group if 
group is empty after deletion
+
+Response codes:
+
+ - 200: Success
+ - 400: Group structure or member is not valid
+ - 500: Internal error
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org
For additional commands, e-mail: server-dev-h...@james.apache.org

Reply via email to