Organizations API

Associate Auditor with the Organization by Username

PUT v2/organizations/:guid/auditors

Request

Route

PUT v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/auditors

Parameters

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

Body

Name Description Default Valid Values Example Values
username The user's name
origin The UAA origin that the user is registered with
  • ldap
{
  "username": "[email protected]"
}

Headers

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTIyOCIsImVtYWlsIjoiZW1haWwtMTY1QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NjYwMDg4OTR9.7dGNYwzyLlEs4djv5Yk7hUFBQaFCiZDhuPBTVxmKFG8
Host: example.org
Content-Type: application/json
Cookie: 

cURL

curl "https://api.[your-domain.com]v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/auditors" -d '{
  "username": "[email protected]"
}' -X PUT \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTIyOCIsImVtYWlsIjoiZW1haWwtMTY1QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0NjYwMDg4OTR9.7dGNYwzyLlEs4djv5Yk7hUFBQaFCiZDhuPBTVxmKFG8" \
	-H "Host: example.org" \
	-H "Content-Type: application/json" \
	-H "Cookie: "

Response

Status

201 Created

Body

{
  "metadata": {
    "guid": "272b3566-04bd-4f3a-b83d-75deb8a67649",
    "url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649",
    "created_at": "2016-06-08T16:41:34Z",
    "updated_at": "2016-06-08T16:41:26Z"
  },
  "entity": {
    "name": "name-1745",
    "billing_enabled": false,
    "quota_definition_guid": "1d25566a-b327-4bab-b179-e7f49c96512b",
    "status": "active",
    "quota_definition_url": "/v2/quota_definitions/1d25566a-b327-4bab-b179-e7f49c96512b",
    "spaces_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/spaces",
    "domains_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/domains",
    "private_domains_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/private_domains",
    "users_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/users",
    "managers_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/managers",
    "billing_managers_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/billing_managers",
    "auditors_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/auditors",
    "app_events_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/app_events",
    "space_quota_definitions_url": "/v2/organizations/272b3566-04bd-4f3a-b83d-75deb8a67649/space_quota_definitions"
  }
}

Headers

Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 17cca19f-1b72-402d-afb2-0d505f8f2a09
Content-Length: 1300
X-Content-Type-Options: nosniff