Update a Household Name


Request Details

Item Value
Description Update an existing household’s name.
Method PUT
Endpoint https://[environment]api[client_id].crowdtwist.com/v2/household/[household_id]?api_key=[api_key]&current_user=[member_id]
Content Type application/json


Request

Field Name Sample Value Required Format Notes
URL PARAMETERS
household_id 10 Yes Integer  
QUERY STRING PARAMETERS
api_key QWERTYUIOP Yes String  
current_user 240835353 Yes Integer The member who is performing this action. This member must be the household owner. (CrowdTwist User ID)

Request Body

Field Name Validation Format Notes
name “John’s Household” String The name of this household.


Successful Response

Field Name Sample Value Format Description
household_id 3 Integer The id of this household
name "John's Household" String The name of this household
date_created "2020-11-16T23:51:12.000Z" String (ISO 8601) The date this household was created
redeemable_points 200 Integer The number of redeemable points currently contributed to this household
members (See Below) Array of member objects The members that are currently part of this household


members

Parameter Sample Value Format Description
id 240835353 Integer The id of this member. (CrowdTwist ID)
date_joined "2020-11-16T23:51:12.000Z" String The date this member joined the household
owner true Boolean True if this member is the owner of the household


Sample Successful Response 

{
    "household_id": 3,
    "name": "John’s Household",
    "date_created": "2020-11-16T23:51:12.000Z",
    "redeemable_points": 200,
    "members": [
        {
            "id": 240835353,
            "date_joined": "2020-11-16T23:51:12.000Z",
            "owner": true
        }
    ]
}

Error Responses

Error Code Description
404 Unable to find household.
400 Only the Head of Household can update the Household.
400 A non-positive integer value was provided for current_user.
400 Missing current_user query parameter.