Session API
Deprecation notice: Starting in GitLab 8.11, this feature has been disabled for users with two-factor authentication turned on. These users can access the API using personal access tokens instead.
You can login with both GitLab and LDAP credentials in order to obtain the private token.
POST /session
Attribute | Type | Required | Description |
---|---|---|---|
login |
string | yes | The username of the user |
email |
string | yes if login is not provided | The email of the user |
password |
string | yes | The password of the user |
curl --request POST "https://gitlab.example.com/api/v4/session?login=john_smith&password=strongpassw0rd"
Example response:
{
"name": "John Smith",
"username": "john_smith",
"id": 32,
"state": "active",
"avatar_url": null,
"created_at": "2015-01-29T21:07:19.440Z",
"is_admin": true,
"bio": null,
"skype": "",
"linkedin": "",
"twitter": "",
"website_url": "",
"email": "john@example.com",
"theme_id": 1,
"color_scheme_id": 1,
"projects_limit": 10,
"current_sign_in_at": "2015-07-07T07:10:58.392Z",
"identities": [],
"can_create_group": true,
"can_create_project": true,
"two_factor_enabled": false,
"private_token": "9koXpg98eAheJpvBs5tK"
}