HTTP Group Update


Optional Fields


memberIds
A JSON list of Identity IDs who will be the members of the Group. Identity IDs can be retrieved by querying the Identity API endpoint
displayName
A descriptive name for the Group
description
Further information used to describe the Group

Request


PUT https://api.flowthings.io/v0.1/<account_id>/group/<groupId>

NOTE: Updating a Group will re-evaluate any Share permissions for any added or removed members of that Group.

Headers

NameDescription
Content-Typeapplication/json
X-Auth-TokenAuthentication Token

Example

PUT https://api.flowthings.io/v0.1/<account_id>/group/g5489f22ed4c66f8dfcbe2794

  {
      "memberIds" : ["i5489e275d4c6f62700be9fd6"]
  }

Response


HTTP Codes

CodeDescription
200Resource Updated
400Bad Request
401Unauthorized
503Service Unavailable

Example

{
  "head": {
    "status": 200,
    "ok": true,
    "messages": [
      "Your request has been processed successfully. A resource has been updated."
    ],
    "errors": []
  },
  "body": {
    "id": "g5489f22ed4c66f8dfcbe2794",
    "creationDate": 1409455732680,
    "displayName": "Research Team",
    "description": "Members of Project Team Y working on the new release",
    "memberIds": [
      "i5489e275d4c6f62700be9fd6"
    ]
  }
}