annotate docs/api/api.rst @ 2091:7dfcdf4c7dd2 beta

implements #361 API method for deleting repositories
author Marcin Kuzminski <marcin@python-works.com>
date Sun, 19 Feb 2012 20:12:01 +0200
parents bdc0ad168006
children 34d009e5147a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
1 .. _api:
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
2
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
3
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
4 API
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
5 ===
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
6
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
7
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
8 Starting from RhodeCode version 1.2 a simple API was implemented.
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
9 There's a single schema for calling all api methods. API is implemented
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
10 with JSON protocol both ways. An url to send API request in RhodeCode is
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
11 <your_server>/_admin/api
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
12
1924
9da24750f563 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1896
diff changeset
13 API ACCESS FOR WEB VIEWS
9da24750f563 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1896
diff changeset
14 ++++++++++++++++++++++++
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
15
1996
0bd97250cd36 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1994
diff changeset
16 API access can also be turned on for each web view in RhodeCode that is
0bd97250cd36 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1994
diff changeset
17 decorated with `@LoginRequired` decorator. To enable API access simple change
0bd97250cd36 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1994
diff changeset
18 the standard login decorator to `@LoginRequired(api_access=True)`.
0bd97250cd36 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1994
diff changeset
19 After this change, a rhodecode view can be accessed without login by adding a
0bd97250cd36 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1994
diff changeset
20 GET parameter `?api_key=<api_key>` to url. By default this is only
1896
320dec24fb9a Added instruction on enabling the API access to web views
Marcin Kuzminski <marcin@python-works.com>
parents: 1895
diff changeset
21 enabled on RSS/ATOM feed views.
320dec24fb9a Added instruction on enabling the API access to web views
Marcin Kuzminski <marcin@python-works.com>
parents: 1895
diff changeset
22
320dec24fb9a Added instruction on enabling the API access to web views
Marcin Kuzminski <marcin@python-works.com>
parents: 1895
diff changeset
23
1924
9da24750f563 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1896
diff changeset
24 API ACCESS
9da24750f563 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1896
diff changeset
25 ++++++++++
9da24750f563 docs update
Marcin Kuzminski <marcin@python-works.com>
parents: 1896
diff changeset
26
1793
fee9895fa46e changed API to match fully JSON-RPC specs
Marcin Kuzminski <marcin@python-works.com>
parents: 1676
diff changeset
27 All clients are required to send JSON-RPC spec JSON data::
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
28
1793
fee9895fa46e changed API to match fully JSON-RPC specs
Marcin Kuzminski <marcin@python-works.com>
parents: 1676
diff changeset
29 {
fee9895fa46e changed API to match fully JSON-RPC specs
Marcin Kuzminski <marcin@python-works.com>
parents: 1676
diff changeset
30 "id:<id>,
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
31 "api_key":"<api_key>",
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
32 "method":"<method_name>",
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
33 "args":{"<arg_key>":"<arg_val>"}
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
34 }
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
35
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
36 Example call for autopulling remotes repos using curl::
1793
fee9895fa46e changed API to match fully JSON-RPC specs
Marcin Kuzminski <marcin@python-works.com>
parents: 1676
diff changeset
37 curl https://server.com/_admin/api -X POST -H 'content-type:text/plain' --data-binary '{"id":1,"api_key":"xe7cdb2v278e4evbdf5vs04v832v0efvcbcve4a3","method":"pull","args":{"repo":"CPython"}}'
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
38
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
39 Simply provide
1793
fee9895fa46e changed API to match fully JSON-RPC specs
Marcin Kuzminski <marcin@python-works.com>
parents: 1676
diff changeset
40 - *id* A value of any type, which is used to match the response with the request that it is replying to.
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
41 - *api_key* for access and permission validation.
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
42 - *method* is name of method to call
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
43 - *args* is an key:value list of arguments to pass to method
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
44
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
45 .. note::
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
46
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
47 api_key can be found in your user account page
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
48
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
49
1793
fee9895fa46e changed API to match fully JSON-RPC specs
Marcin Kuzminski <marcin@python-works.com>
parents: 1676
diff changeset
50 RhodeCode API will return always a JSON-RPC response::
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
51
1793
fee9895fa46e changed API to match fully JSON-RPC specs
Marcin Kuzminski <marcin@python-works.com>
parents: 1676
diff changeset
52 {
fee9895fa46e changed API to match fully JSON-RPC specs
Marcin Kuzminski <marcin@python-works.com>
parents: 1676
diff changeset
53 "id":<id>,
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
54 "result": "<result>",
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
55 "error": null
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
56 }
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
57
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
58 All responses from API will be `HTTP/1.0 200 OK`, if there's an error while
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
59 calling api *error* key from response will contain failure description
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
60 and result will be null.
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
61
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
62 API METHODS
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
63 +++++++++++
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
64
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
65
1526
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
66 pull
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
67 ----
eab0cf9ab8bf API docs
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
68
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
69 Pulls given repo from remote location. Can be used to automatically keep
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
70 remote repos up to date. This command can be executed only using api_key
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
71 belonging to user with admin rights
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
72
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
73 INPUT::
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
74
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
75 api_key : "<api_key>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
76 method : "pull"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
77 args : {
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
78 "repo_name" : "<reponame>"
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
79 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
80
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
81 OUTPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
82
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
83 result : "Pulled from <reponame>"
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
84 error : null
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
85
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
86
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
87 get_user
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
88 --------
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
89
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
90 Get's an user by username, Returns empty result if user is not found.
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
91 This command can be executed only using api_key belonging to user with admin
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
92 rights.
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
93
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
94
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
95 INPUT::
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
96
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
97 api_key : "<api_key>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
98 method : "get_user"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
99 args : {
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
100 "username" : "<username>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
101 }
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
102
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
103 OUTPUT::
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
104
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
105 result: None if user does not exist or
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
106 {
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
107 "id" : "<id>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
108 "username" : "<username>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
109 "firstname": "<firstname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
110 "lastname" : "<lastname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
111 "email" : "<email>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
112 "active" : "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
113 "admin" :  "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
114 "ldap" : "<ldap_dn>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
115 }
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
116
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
117 error: null
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
118
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
119
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
120 get_users
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
121 ---------
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
122
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
123 Lists all existing users. This command can be executed only using api_key
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
124 belonging to user with admin rights.
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
125
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
126
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
127 INPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
128
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
129 api_key : "<api_key>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
130 method : "get_users"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
131 args : { }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
132
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
133 OUTPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
134
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
135 result: [
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
136 {
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
137 "id" : "<id>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
138 "username" : "<username>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
139 "firstname": "<firstname>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
140 "lastname" : "<lastname>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
141 "email" : "<email>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
142 "active" : "<bool>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
143 "admin" :  "<bool>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
144 "ldap" : "<ldap_dn>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
145 },
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
146 …
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
147 ]
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
148 error: null
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
149
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
150
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
151 create_user
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
152 -----------
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
153
2090
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
154 Creates new user. This command can
1994
f2bd5b0c1094 create user api_doc update
Marcin Kuzminski <marcin@python-works.com>
parents: 1928
diff changeset
155 be executed only using api_key belonging to user with admin rights.
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
156
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
157
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
158 INPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
159
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
160 api_key : "<api_key>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
161 method : "create_user"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
162 args : {
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
163 "username" : "<username>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
164 "password" : "<password>",
2036
4ae17f819ee8 #344 optional firstname lastname on user creation
Marcin Kuzminski <marcin@python-works.com>
parents: 1996
diff changeset
165 "email" : "<useremail>",
4ae17f819ee8 #344 optional firstname lastname on user creation
Marcin Kuzminski <marcin@python-works.com>
parents: 1996
diff changeset
166 "firstname" : "<firstname> = None",
4ae17f819ee8 #344 optional firstname lastname on user creation
Marcin Kuzminski <marcin@python-works.com>
parents: 1996
diff changeset
167 "lastname" : "<lastname> = None",
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
168 "active" : "<bool> = True",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
169 "admin" : "<bool> = False",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
170 "ldap_dn" : "<ldap_dn> = None"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
171 }
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
172
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
173 OUTPUT::
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
174
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
175 result: {
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
176 "id" : "<new_user_id>",
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
177 "msg" : "created new user <username>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
178 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
179 error: null
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
180
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
181
2090
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
182 update_user
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
183 -----------
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
184
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
185 updates current one if such user exists. This command can
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
186 be executed only using api_key belonging to user with admin rights.
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
187
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
188
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
189 INPUT::
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
190
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
191 api_key : "<api_key>"
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
192 method : "update_user"
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
193 args : {
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
194 "username" : "<username>",
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
195 "password" : "<password>",
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
196 "email" : "<useremail>",
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
197 "firstname" : "<firstname> = None",
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
198 "lastname" : "<lastname> = None",
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
199 "active" : "<bool> = True",
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
200 "admin" : "<bool> = False",
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
201 "ldap_dn" : "<ldap_dn> = None"
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
202 }
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
203
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
204 OUTPUT::
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
205
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
206 result: {
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
207 "id" : "<edited_user_id>",
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
208 "msg" : "updated user <username>"
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
209 }
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
210 error: null
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
211
bdc0ad168006 API added explicit method for updating user account
Marcin Kuzminski <marcin@python-works.com>
parents: 2077
diff changeset
212
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
213 get_users_group
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
214 ---------------
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
215
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
216 Gets an existing users group. This command can be executed only using api_key
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
217 belonging to user with admin rights.
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
218
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
219
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
220 INPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
221
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
222 api_key : "<api_key>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
223 method : "get_users_group"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
224 args : {
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
225 "group_name" : "<name>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
226 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
227
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
228 OUTPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
229
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
230 result : None if group not exist
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
231 {
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
232 "id" : "<id>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
233 "group_name" : "<groupname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
234 "active": "<bool>",
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
235 "members" : [
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
236 { "id" : "<userid>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
237 "username" : "<username>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
238 "firstname": "<firstname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
239 "lastname" : "<lastname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
240 "email" : "<email>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
241 "active" : "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
242 "admin" :  "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
243 "ldap" : "<ldap_dn>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
244 },
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
245 …
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
246 ]
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
247 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
248 error : null
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
249
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
250
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
251 get_users_groups
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
252 ----------------
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
253
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
254 Lists all existing users groups. This command can be executed only using
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
255 api_key belonging to user with admin rights.
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
256
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
257
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
258 INPUT::
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
259
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
260 api_key : "<api_key>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
261 method : "get_users_groups"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
262 args : { }
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
263
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
264 OUTPUT::
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
265
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
266 result : [
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
267 {
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
268 "id" : "<id>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
269 "group_name" : "<groupname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
270 "active": "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
271 "members" : [
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
272 {
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
273 "id" : "<userid>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
274 "username" : "<username>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
275 "firstname": "<firstname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
276 "lastname" : "<lastname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
277 "email" : "<email>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
278 "active" : "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
279 "admin" :  "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
280 "ldap" : "<ldap_dn>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
281 },
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
282 …
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
283 ]
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
284 }
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
285 ]
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
286 error : null
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
287
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
288
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
289 create_users_group
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
290 ------------------
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
291
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
292 Creates new users group. This command can be executed only using api_key
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
293 belonging to user with admin rights
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
294
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
295
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
296 INPUT::
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
297
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
298 api_key : "<api_key>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
299 method : "create_users_group"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
300 args: {
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
301 "group_name": "<groupname>",
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
302 "active":"<bool> = True"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
303 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
304
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
305 OUTPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
306
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
307 result: {
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
308 "id": "<newusersgroupid>",
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
309 "msg": "created new users group <groupname>"
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
310 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
311 error: null
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
312
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
313
1878
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
314 add_user_to_users_group
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
315 -----------------------
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
316
2077
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
317 Adds a user to a users group. If user exists in that group success will be
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
318 `false`. This command can be executed only using api_key
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
319 belonging to user with admin rights
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
320
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
321
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
322 INPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
323
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
324 api_key : "<api_key>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
325 method : "add_user_users_group"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
326 args: {
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
327 "group_name" : "<groupname>",
1895
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
328 "username" : "<username>"
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
329 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
330
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
331 OUTPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
332
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
333 result: {
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
334 "id": "<newusersgroupmemberid>",
2077
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
335 "success": True|False # depends on if member is in group
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
336 "msg": "added member <username> to users group <groupname> |
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
337 User is already in that group"
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
338 }
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
339 error: null
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
340
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
341
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
342 remove_user_from_users_group
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
343 ----------------------------
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
344
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
345 Removes a user from a users group. If user is not in given group success will
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
346 be `false`. This command can be executed only
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
347 using api_key belonging to user with admin rights
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
348
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
349
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
350 INPUT::
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
351
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
352 api_key : "<api_key>"
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
353 method : "remove_user_from_users_group"
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
354 args: {
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
355 "group_name" : "<groupname>",
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
356 "username" : "<username>"
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
357 }
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
358
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
359 OUTPUT::
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
360
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
361 result: {
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
362 "success": True|False, # depends on if member is in group
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
363 "msg": "removed member <username> from users group <groupname> |
0f87c784756e API changes
Marcin Kuzminski <marcin@python-works.com>
parents: 2070
diff changeset
364 User wasn't in group"
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
365 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
366 error: null
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
367
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
368
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
369 get_repo
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
370 --------
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
371
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
372 Gets an existing repository. This command can be executed only using api_key
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
373 belonging to user with admin rights
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
374
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
375
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
376 INPUT::
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
377
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
378 api_key : "<api_key>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
379 method : "get_repo"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
380 args: {
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
381 "repo_name" : "<reponame>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
382 }
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
383
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
384 OUTPUT::
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
385
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
386 result: None if repository does not exist or
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
387 {
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
388 "id" : "<id>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
389 "repo_name" : "<reponame>"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
390 "type" : "<type>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
391 "description" : "<description>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
392 "members" : [
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
393 { "id" : "<userid>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
394 "username" : "<username>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
395 "firstname": "<firstname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
396 "lastname" : "<lastname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
397 "email" : "<email>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
398 "active" : "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
399 "admin" :  "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
400 "ldap" : "<ldap_dn>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
401 "permission" : "repository.(read|write|admin)"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
402 },
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
403 …
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
404 {
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
405 "id" : "<usersgroupid>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
406 "name" : "<usersgroupname>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
407 "active": "<bool>",
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
408 "permission" : "repository.(read|write|admin)"
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
409 },
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
410 …
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
411 ]
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
412 }
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
413 error: null
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
414
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
415
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
416 get_repos
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
417 ---------
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
418
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
419 Lists all existing repositories. This command can be executed only using api_key
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
420 belonging to user with admin rights
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
421
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
422
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
423 INPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
424
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
425 api_key : "<api_key>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
426 method : "get_repos"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
427 args: { }
1580
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
428
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
429 OUTPUT::
256e729a94cd Extended API
Marcin Kuzminski <marcin@python-works.com>
parents: 1572
diff changeset
430
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
431 result: [
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
432 {
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
433 "id" : "<id>",
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
434 "repo_name" : "<reponame>"
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
435 "type" : "<type>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
436 "description" : "<description>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
437 },
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
438 …
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
439 ]
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
440 error: null
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
441
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
442
1895
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
443 get_repo_nodes
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
444 --------------
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
445
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
446 returns a list of nodes and it's children in a flat list for a given path
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
447 at given revision. It's possible to specify ret_type to show only `files` or
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
448 `dirs`. This command can be executed only using api_key belonging to user
1895
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
449 with admin rights
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
450
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
451
1895
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
452 INPUT::
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
453
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
454 api_key : "<api_key>"
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
455 method : "get_repo_nodes"
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
456 args: {
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
457 "repo_name" : "<reponame>",
1895
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
458 "revision" : "<revision>",
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
459 "root_path" : "<root_path>",
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
460 "ret_type" : "<ret_type>" = 'all'
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
461 }
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
462
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
463 OUTPUT::
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
464
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
465 result: [
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
466 {
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
467 "name" : "<name>"
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
468 "type" : "<type>",
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
469 },
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
470 …
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
471 ]
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
472 error: null
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
473
203af05539e0 implements #330 api method for listing nodes at particular revision
Marcin Kuzminski <marcin@python-works.com>
parents: 1878
diff changeset
474
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
475 create_repo
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
476 -----------
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
477
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
478 Creates a repository. This command can be executed only using api_key
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
479 belonging to user with admin rights.
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
480 If repository name contains "/", all needed repository groups will be created.
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
481 For example "foo/bar/baz" will create groups "foo", "bar" (with "foo" as parent),
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
482 and create "baz" repository with "bar" as group.
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
483
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
484
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
485 INPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
486
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
487 api_key : "<api_key>"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
488 method : "create_repo"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
489 args: {
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
490 "repo_name" : "<reponame>",
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
491 "owner_name" : "<ownername>",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
492 "description" : "<description> = ''",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
493 "repo_type" : "<type> = 'hg'",
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
494 "private" : "<bool> = False"
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
495 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
496
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
497 OUTPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
498
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
499 result: {
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
500 "id": "<newrepoid>",
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
501 "msg": "Created new repository <reponame>",
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
502 }
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
503 error: null
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
504
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
505
2091
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
506 delete_repo
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
507 -----------
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
508
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
509 Deletes a repository. This command can be executed only using api_key
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
510 belonging to user with admin rights.
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
511
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
512
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
513 INPUT::
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
514
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
515 api_key : "<api_key>"
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
516 method : "delete_repo"
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
517 args: {
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
518 "repo_name" : "<reponame>",
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
519 }
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
520
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
521 OUTPUT::
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
522
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
523 result: {
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
524 "msg": "Deleted repository <reponame>",
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
525 }
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
526 error: null
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
527
7dfcdf4c7dd2 implements #361 API method for deleting repositories
Marcin Kuzminski <marcin@python-works.com>
parents: 2090
diff changeset
528
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
529 grant_user_permission
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
530 ---------------------
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
531
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
532 Grant permission for user on given repository, or update existing one
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
533 if found. This command can be executed only using api_key belonging to user
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
534 with admin rights.
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
535
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
536
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
537 INPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
538
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
539 api_key : "<api_key>"
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
540 method : "grant_user_permission"
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
541 args: {
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
542 "repo_name" : "<reponame>",
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
543 "username" : "<username>",
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
544 "perm" : "(repository.(none|read|write|admin))",
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
545 }
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
546
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
547 OUTPUT::
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
548
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
549 result: {
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
550 "msg" : "Granted perm: <perm> for user: <username> in repo: <reponame>"
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
551 }
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
552 error: null
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
553
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
554
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
555 revoke_user_permission
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
556 ----------------------
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
557
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
558 Revoke permission for user on given repository. This command can be executed
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
559 only using api_key belonging to user with admin rights.
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
560
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
561
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
562 INPUT::
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
563
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
564 api_key : "<api_key>"
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
565 method : "revoke_user_permission"
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
566 args: {
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
567 "repo_name" : "<reponame>",
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
568 "username" : "<username>",
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
569 }
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
570
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
571 OUTPUT::
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
572
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
573 result: {
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
574 "msg" : "Revoked perm for user: <suername> in repo: <reponame>"
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
575 }
1676
8628c8706bf8 [API] Update doc
Nicolas VINOT <aeris@imirhil.fr>
parents: 1580
diff changeset
576 error: null
1878
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
577
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
578
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
579 grant_users_group_permission
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
580 ----------------------------
1878
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
581
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
582 Grant permission for users group on given repository, or update
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
583 existing one if found. This command can be executed only using
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
584 api_key belonging to user with admin rights.
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
585
1878
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
586
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
587 INPUT::
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
588
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
589 api_key : "<api_key>"
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
590 method : "grant_users_group_permission"
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
591 args: {
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
592 "repo_name" : "<reponame>",
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
593 "group_name" : "<usersgroupname>",
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
594 "perm" : "(repository.(none|read|write|admin))",
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
595 }
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
596
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
597 OUTPUT::
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
598
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
599 result: {
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
600 "msg" : "Granted perm: <perm> for group: <usersgroupname> in repo: <reponame>"
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
601 }
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
602 error: null
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
603
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
604
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
605 revoke_users_group_permission
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
606 -----------------------------
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
607
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
608 Revoke permission for users group on given repository.This command can be
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
609 executed only using api_key belonging to user with admin rights.
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
610
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
611 INPUT::
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
612
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
613 api_key : "<api_key>"
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
614 method : "revoke_users_group_permission"
1878
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
615 args: {
631caf880b87 implements #329
Marcin Kuzminski <marcin@python-works.com>
parents: 1793
diff changeset
616 "repo_name" : "<reponame>",
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
617 "users_group" : "<usersgroupname>",
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
618 }
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
619
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
620 OUTPUT::
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
621
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
622 result: {
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
623 "msg" : "Revoked perm for group: <usersgroupname> in repo: <reponame>"
1928
0771f0f5ab28 api review
Marcin Kuzminski <marcin@python-works.com>
parents: 1924
diff changeset
624 }
2070
87f0800abc7b #227 Initial version of repository groups permissions system
Marcin Kuzminski <marcin@python-works.com>
parents: 2036
diff changeset
625 error: null