Group and project access requests API

Note:This feature was introduced in GitLab 8.11

Valid access levels

The access levels are defined in theGitlab::Accessmodule. Currently, these levels are recognized:

10 => Guest access20 => Reporter access30 => Developer access40 => Master access50 => Owner access # Only valid for groups

List access requests for a group or project

Gets a list of access requests viewable by the authenticated user.

GET /groups/:id/access_requestsGET /projects/:id/access_requests

Attribute	Type	Required	Description
id	integer/string	yes	The ID orURL-encoded path of the projectowned by the authenticated user

旋度--header"PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK"https://gitlab.example.com/api/v4/groups/:id/access_requests旋度--header"PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK"https://gitlab.example.com/api/v4/projects/:id/access_requests

Example response:

[{"id":1,"username":"raymond_smith","name":"Raymond Smith","state":"active","created_at":"2012-10-22T14:13:35Z","requested_at":"2012-10-22T14:13:35Z"},{"id":2,"username":"john_doe","name":"John Doe","state":"active","created_at":"2012-10-22T14:13:35Z","requested_at":"2012-10-22T14:13:35Z"}]

Request access to a group or project

Requests access for the authenticated user to a group or project.

POST /groups/:id/access_requestsPOST /projects/:id/access_requests

Attribute	Type	Required	Description
id	integer/string	yes	The ID orURL-encoded path of the projectowned by the authenticated user

旋度--requestPOST--header"PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK"https://gitlab.example.com/api/v4/groups/:id/access_requests旋度--requestPOST--header"PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK"https://gitlab.example.com/api/v4/projects/:id/access_requests

Example response:

{"id":1,"username":"raymond_smith","name":"Raymond Smith","state":"active","created_at":"2012-10-22T14:13:35Z","requested_at":"2012-10-22T14:13:35Z"}

Approve an access request

批准一个给定用户的访问请求.

PUT /groups/:id/access_requests/:user_id/approvePUT /projects/:id/access_requests/:user_id/approve

Attribute	Type	Required	Description
id	integer/string	yes	The ID orURL-encoded path of the projectowned by the authenticated user
user_id	integer	yes	The user ID of the access requester
access_level	integer	no	A valid access level (defaults:30, developer access level)

旋度--requestPUT--header"PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK"https://gitlab.example.com/api/v4/groups/:id/access_requests/:user_id/approve?access_level=20旋度--requestPUT--header"PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK"https://gitlab.example.com/api/v4/projects/:id/access_requests/:user_id/approve?access_level=20

Example response:

{"id":1,"username":"raymond_smith","name":"Raymond Smith","state":"active","created_at":"2012-10-22T14:13:35Z","access_level":20}

Deny an access request

Denies an access request for the given user.

DELETE /groups/:id/access_requests/:user_idDELETE /projects/:id/access_requests/:user_id

Attribute	Type	Required	Description
id	integer/string	yes	The ID orURL-encoded path of the projectowned by the authenticated user
user_id	integer	yes	The user ID of the access requester

旋度--requestDELETE--header"PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK"https://gitlab.example.com/api/v4/groups/:id/access_requests/:user_id旋度--requestDELETE--header"PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK"https://gitlab.example.com/api/v4/projects/:id/access_requests/:user_id