Accounts-accountId-attributes-attribute:PUT
From Hostway API Documentation
Revision as of 12:12, 24 July 2015 by Mike.robski (Talk | contribs)
PUT /accounts/{accountId}/attributes/{attribute}
Updates attribute value.
Contents |
Request
PUT /accounts/{accountId}/attributes/{attribute}
Parameters
- accountId - string
- The Id of the Hostway account.
URI Parameters
- attribute - string
Request Headers
- Authorization - HTTP Authorization header [1]
- The Authentication credentials of the client application.
- Content-Type
- application/json
Request Body
{
"value": "{value}"
}
Parameters
- value - string
Response
Status Code
- 204 No Content
- Success.
- 400 Bad Request
- The format of the request body is invalid.
- 401 Unauthorized
- The supplied credentials are invalid or do not provide permissions for this operation.
- 403 Forbidden
- Forbidden access to a user not authorized for such access.
- 404 Not Found
- The account Id or attribute were not found.
- 415 Unsupported Media Type
- The Content-Type header was not specified or the specified type is not supported. Use application/json.
Examples
Sending unauthorized request
Request
PUT /accounts/account-id/attributes/test_attribute
{"value": "test"}
Response
401 Unauthorized
Sending request without setting Content-Type
Request
PUT /accounts/account-id/attributes/test_attribute
Authorization: Basic base64_encode(username:password)
{"value": "test"}
Response
415 Unsupported Media Type
Failure updating not existing attribute
Request
PUT /accounts/account-id/attributes/not_existing_attribute
Authorization: Basic base64_encode(username:password)
Content-Type: application/json
{"value": "test"}
Response
404 Not Found
Failure updating attribute with missing required value
Request
PUT /accounts/account-id/attributes/not_existing_attribute
Authorization: Basic base64_encode(username:password)
Content-Type: application/json
{}
Response
400 Bad Request
{"value":"Required"}
Success scenario
Request
PUT /accounts/account-id/attributes/test_attribute
Authorization: Basic base64_encode(username:password)
Content-Type: application/json
{"value": "test"}
Response
204 No Content
See also
