Home
Version 3
Users API

Users API

Updating a User

PUT /v2/users/:guid

Fields

Name Description Default Valid Values Example Values
default_space_guid The guid of the default space for apps created by this user.
admin Whether the user is an admin (Use UAA instead).

Parameters

Name Description Valid Values Example Values
guid The guid of the User

Request

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTgwIiwiZW1haWwiOiJlbWFpbC01OUBzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDI0MTM3MzY0fQ.FmWqTn5A068pOyadbw7x4hOlfU9hp95eG4WhkdSBOSA
Host: example.org
Content-Type: application/x-www-form-urlencoded
Cookie: 

Route

PUT /v2/users/uaa-id-79

Body

{
  "default_space_guid": "5bd57dac-8f11-420b-a957-b6808b11d5e2"
}

cURL

curl "https://api.[your-domain.com]/v2/users/uaa-id-79" -d '{
  "default_space_guid": "5bd57dac-8f11-420b-a957-b6808b11d5e2"
}' -X PUT \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTgwIiwiZW1haWwiOiJlbWFpbC01OUBzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDI0MTM3MzY0fQ.FmWqTn5A068pOyadbw7x4hOlfU9hp95eG4WhkdSBOSA" \
	-H "Host: example.org" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: f36fd348-232b-44c1-8ba8-f1172e6a34c8
Content-Length: 854
X-Content-Type-Options: nosniff

Status

201 Created

Body

{
  "metadata": {
    "guid": "uaa-id-79",
    "url": "/v2/users/uaa-id-79",
    "created_at": "2015-02-10T01:42:44Z",
    "updated_at": "2015-02-10T01:42:44Z"
  },
  "entity": {
    "admin": false,
    "active": false,
    "default_space_guid": "5bd57dac-8f11-420b-a957-b6808b11d5e2",
    "default_space_url": "/v2/spaces/5bd57dac-8f11-420b-a957-b6808b11d5e2",
    "spaces_url": "/v2/users/uaa-id-79/spaces",
    "organizations_url": "/v2/users/uaa-id-79/organizations",
    "managed_organizations_url": "/v2/users/uaa-id-79/managed_organizations",
    "billing_managed_organizations_url": "/v2/users/uaa-id-79/billing_managed_organizations",
    "audited_organizations_url": "/v2/users/uaa-id-79/audited_organizations",
    "managed_spaces_url": "/v2/users/uaa-id-79/managed_spaces",
    "audited_spaces_url": "/v2/users/uaa-id-79/audited_spaces"
  }
}