{"_id":"56c50634bdcde80d004986c4","user":"54774c47f3736008009e9e0c","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"},"__v":0,"category":{"_id":"56c50628bdcde80d00498642","project":"54774d9af3736008009e9e0e","__v":1,"version":"56c50626bdcde80d00498635","pages":["56c50634bdcde80d004986c0","56c50634bdcde80d004986c1","56c50634bdcde80d004986c2","56c50634bdcde80d004986c3","56c50634bdcde80d004986c4","56c50634bdcde80d004986c5","56c50634bdcde80d004986c6","56c50634bdcde80d004986c7","56c50634bdcde80d004986c8","56c50634bdcde80d004986c9","56c50634bdcde80d004986ca"],"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-04-15T06:31:05.605Z","from_sync":false,"order":14,"slug":"users","title":"Users"},"parentDoc":null,"editedParams":true,"project":"54774d9af3736008009e9e0e","editedParams2":true,"githubsync":"","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-04-15T08:56:36.510Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"curl","code":"curl -X PATCH \\\n-H \"X-API-KEY: <API_KEY>\" \\\n-H \"X-USER-KEY: USER_KEY\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\"username\":\"<username>\"}' \\\n\"https://api.syncano.io/v1.1/instances/<instance_name>/users/<user_id>/\"","name":""},{"language":"python","code":"import syncano\nfrom syncano.models import User\n\nsyncano.connect(api_key=\"API_KEY\", user_key=\"USER_KEY\", instance_name=\"INSTANCE_NAME\")\n\nUser.please.update(\n    ID=USER_ID,\n    username=\"NEW_USERNAME\"\n)\n"},{"language":"javascript","code":"var Syncano = require(\"syncano\");\nvar connection = Syncano({apiKey: \"API_KEY\", userKey: \"USER_KEY\"});\nvar User = connection.User;\n\nvar query = {instanceName: INSTANCE_NAME, id: USER_ID};\nvar update = {username: USERNAME, password: PASSWORD};\n\nUser.please().update(query, update).then(callback);"}]},"method":"patch","results":{"codes":[{"status":200,"language":"json","code":"{\n    \"username\": \"<username>\",\n    \"profile\": {\n        \"channel_room\": null,\n        \"group\": null,\n        \"links\": {\n            \"owner\": \"/v1/instances/<instance_name>/users/1/\",\n            \"self\": \"/v1/instances/<instance_name>/classes/user_profile/objects/1/\"\n        },\n        \"group_permissions\": \"none\",\n        \"created_at\": \"2016-06-20T08:43:27.204105Z\",\n        \"owner_permissions\": \"full\",\n        \"updated_at\": \"2016-06-20T08:43:27.204122Z\",\n        \"other_permissions\": \"none\",\n        \"owner\": 1,\n        \"age\": null,\n        \"nickname\": null,\n        \"id\": 1,\n        \"channel\": null,\n        \"revision\": 1\n    },\n    \"links\": {\n        \"profile\": \"/v1/instances/<instance_name>/classes/user_profile/objects/1/\",\n        \"self\": \"/v1/instances/<instance_name>/users/1/\",\n        \"groups\": \"/v1/instances/<instance_name>/users/1/groups/\",\n        \"reset-key\": \"/v1/instances/<instance_name>/users/1/reset_key/\"\n    },\n    \"user_key\": \"15e8b35e1cd9b8abf806f3e925951f2612bf0d20\",\n    \"groups\": [\n        {\n            \"description\": \"\",\n            \"id\": 1,\n            \"links\": {\n                \"self\": \"/v1/instances/<instance_name>/groups/1/\",\n                \"users\": \"/v1/instances/<instance_name>/groups/1/users/\"\n            },\n            \"label\": \"main_group\"\n        }\n    ],\n    \"id\": 1\n}","name":""},{"status":400,"language":"json","code":"{\n  \"username\": [\n    \"Ensure this value has at most 64 characters (it has 118).\"\n  ]\n}","name":""},{"status":403,"language":"json","code":"{\n  \"detail\": \"No such API Key.\"\n}"},{"status":404,"language":"json","code":"{\n  \"detail\": \"Not found\"\n}"}]},"settings":"56c50c06d1b8770d00922288","auth":"required","params":[{"_id":"552e06b95d4baa0d007835ee","ref":"","in":"path","required":true,"desc":"Name of the instance that the application users belong to.","default":"","type":"string","name":"instance_name"},{"_id":"552e0a895d4baa0d007835f6","ref":"","in":"path","required":true,"desc":"ID of the user.","default":"","type":"int","name":"user_id"},{"_id":"552e09a906a32a0d009c2eb5","ref":"","in":"body","required":false,"desc":"Username of the user.","default":"","type":"string","name":"username"},{"_id":"552e09a906a32a0d009c2eb4","ref":"","in":"body","required":false,"desc":"Password of the user.","default":"","type":"string","name":"password"}],"url":"/instances/:instance_name/users/:user_id/"},"isReference":true,"order":4,"body":"Updates user data. Fields that can be updated are `username` and `password`. Using the PATCH method, you can change either `username` or `password` (providing none is also possible, but it will of course not perform any changes).\n\nYou can read more about user_profile in [User management](http://docs.syncano.io/v0.1.1/docs/user-update-patch) section of Syncano documentation.","excerpt":"","slug":"users-update-patch","type":"endpoint","title":"Users - update"}

patchUsers - update


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

instance_name:
required
string
Name of the instance that the application users belong to.
user_id:
required
integer
ID of the user.

Body Params

username:
string
Username of the user.
password:
string
Password of the user.

Examples


Result Format


Documentation

Updates user data. Fields that can be updated are `username` and `password`. Using the PATCH method, you can change either `username` or `password` (providing none is also possible, but it will of course not perform any changes). You can read more about user_profile in [User management](http://docs.syncano.io/v0.1.1/docs/user-update-patch) section of Syncano documentation.

User Information

Try It Out

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