{"_id":"56c50632bdcde80d004986b2","__v":0,"category":{"_id":"56c50628bdcde80d00498644","pages":["56c50632bdcde80d004986b2","56c50632bdcde80d004986b3","56c50632bdcde80d004986b4","56c50632bdcde80d004986b5","56c50632bdcde80d004986b6"],"project":"54774d9af3736008009e9e0e","version":"56c50626bdcde80d00498635","__v":1,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-04-02T12:24:37.714Z","from_sync":false,"order":16,"slug":"user","title":"User"},"version":{"_id":"56c50626bdcde80d00498635","project":"54774d9af3736008009e9e0e","__v":10,"createdAt":"2016-02-17T23:45:42.869Z","releaseDate":"2016-02-17T23:45:42.869Z","categories":["56c50628bdcde80d00498636","56c50628bdcde80d00498637","56c50628bdcde80d00498638","56c50628bdcde80d00498639","56c50628bdcde80d0049863a","56c50628bdcde80d0049863b","56c50628bdcde80d0049863c","56c50628bdcde80d0049863d","56c50628bdcde80d0049863e","56c50628bdcde80d0049863f","56c50628bdcde80d00498640","56c50628bdcde80d00498641","56c50628bdcde80d00498642","56c50628bdcde80d00498643","56c50628bdcde80d00498644","56c50628bdcde80d00498645","56c50628bdcde80d00498646","56c50628bdcde80d00498647","56c506a018f0c90d002808de","56c6b0baf795cf0d003ec13e","56fe58eb5a08190e00085149","571764513cf2960e0009a635","571fc008ffbc6a2000b25bb5","5739ca371f4b740e00b06e09","577522f197a3830e004bcc1b","57753d5ffecd260e00d86ce6","57adb71efaa7a10e004495b6"],"is_deprecated":true,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"API v1.1","version_clean":"0.1.1","version":"0.1.1"},"editedParams2":true,"project":"54774d9af3736008009e9e0e","githubsync":"","editedParams":true,"parentDoc":null,"user":"54774c47f3736008009e9e0c","metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-04-02T12:25:12.357Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"curl","code":"curl -X POST \\\n-H \"X-API-KEY: <API_KEY>\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\"username\":\"geralt\",\n     \"password\":\"geralt\"}' \\\n\"https://api.syncano.io/v1.1/instances/<instance>/user/auth/\"","name":""},{"language":"python","code":"import syncano\n\nsyncano.connect(\n    api_key=\"API_KEY\",\n    instance_name=\"INSTANCE_NAME\",\n    username=\"Gordon Freeman\",\n    password=\"Black Mesa\"\n)\n"},{"language":"javascript","code":"var Syncano = require(\"syncano\");\nvar connection = Syncano({apiKey: \"API_KEY\"});\nvar User = connection.User;\n\nvar query = {instanceName: \"INSTANCE_NAME\"};\nvar credentials = {email: \"EMAIL\", password: \"PASSWORD\"};\n\nUser.please().login(query, credentials).then(callback);"}]},"method":"post","results":{"codes":[{"name":"","code":"{\n  \"username\": \"geralt\",\n  \"profile\": {\n    \"channel_room\": null,\n    \"group\": null,\n    \"links\": {\n      \"owner\": \"/v1.1/instances/rivia/users/9/\",\n      \"self\": \"/v1.1/instances/rivia/classes/user_profile/objects/33/\"\n    },\n    \"group_permissions\": \"none\",\n    \"created_at\": \"2016-03-11T18:29:54.051209Z\",\n    \"owner_permissions\": \"full\",\n    \"updated_at\": \"2016-03-11T18:29:54.051230Z\",\n    \"other_permissions\": \"none\",\n    \"owner\": 9,\n    \"id\": 33,\n    \"channel\": null,\n    \"revision\": 1\n  },\n  \"links\": {\n    \"profile\": \"/v1.1/instances/rivia/classes/user_profile/objects/33/\",\n    \"self\": \"/v1.1/instances/rivia/users/9/\",\n    \"groups\": \"/v1.1/instances/rivia/users/9/groups/\",\n    \"reset-key\": \"/v1.1/instances/rivia/users/9/reset_key/\"\n  },\n  \"user_key\": \"a262b3875566fb0d669ec8c22dafb648fbbea392\",\n  \"groups\": [],\n  \"id\": 9\n}","language":"json","status":200},{"name":"","code":"{\n  \"detail\": \"JSON parse error - Expecting property name enclosed in double quotes: line 2 column 28 (char 49)\"\n}","language":"json","status":400},{"language":"json","code":"{\n  \"detail\": \"Invalid username or password.\"\n}","status":401},{"status":403,"language":"json","code":"{\n  \"detail\": \"No such API Key.\"\n}"},{"status":404,"language":"json","code":"{\n  \"detail\": \"Instance was not found.\"\n}"}]},"settings":"56c50c06d1b8770d00922288","auth":"required","params":[{"_id":"551d39773c66970d00d20bd2","ref":"","in":"path","required":true,"desc":"Instance name","default":"","type":"string","name":"instance_name"},{"_id":"551d37e3e52a0b23000c61b4","ref":"","in":"body","required":true,"desc":"Name of your user","default":"","type":"string","name":"username"},{"_id":"551d37e3e52a0b23000c61b3","ref":"","in":"body","required":true,"desc":"Password of your user","default":"","type":"string","name":"password"}],"url":"/instances/:instance_name/user/auth/"},"isReference":true,"order":0,"body":"Logs in your application users.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"When using this endpoint, you should authenticate with an API Key. Using Account Key will work but for security reasons we strongly recommend that you use your API Key instead.\",\n  \"title\": \"API Key vs Account Key\"\n}\n[/block]","excerpt":"","slug":"user-log-in","type":"endpoint","title":"User - log in"}

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

instance_name:
required
string
Instance name

Body Params

username:
required
string
Name of your user
password:
required
string
Password of your user

Examples


Result Format


Documentation

Logs in your application users. [block:callout] { "type": "warning", "body": "When using this endpoint, you should authenticate with an API Key. Using Account Key will work but for security reasons we strongly recommend that you use your API Key instead.", "title": "API Key vs Account Key" } [/block]

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}