Update Membership

Update a the role or permissions of a membership.

Requires the hubs-members-manage permission.

query
  • include

    Accepted Values: sendershubsaccounts

  • meta

    Accepted Values: capabilities

  • sort

    Sorts can be performed on any field - see sorting

  • filter

    Collections of resources can be filtered based on certain criteria - see filtering 

Arguments
  • role
    string
    optional

    Update the role of the membership.
    owner | admin | developer |analyst

  • permissions
    object
    optional

    Update the memberships environment permissions.

Returns

Returns a member resource, otherwise returns an Error.

PATCH /v1/hubs/current/members/{ID}

Example Request
$ curl https://api.cycle.io/v1/hubs/current/members/5a232a77b6393d0001ac2df2 \
-H 
'Authorization: Bearer API_KEY'
 \
-H 
'X-Hub-Id: HUB_ID'
 \
-H 'Content-Type: application/json' \
-d '{"role":"admin","capabilities":{"all_environments":false,"environments":[{"id":"5cc78aa0db2ab000014a8b98","manage":false}]}}' \
-X PATCH
Example Response
{
  "data": {
    "id": "5b9c2a77b6393d0001eb45fd",
    "account_id": "5a232a77b6393d0001ac2df2",
    "hub_id": "5ccc2a2226393d1231eb4abd",
    "events": {
      "created": "2021-04-06T18:32:21.783Z",
      "updated": "2021-04-12T19:57:49.767Z",
      "deleted": "0001-01-01T00:00:00Z",
      "joined": "2021-04-06T18:32:27.02Z"
    },
    "state": {
      "changed": "2021-04-06T18:32:27.092Z",
      "current": "accepted"
    },
    "role": 2,
    "permissions": {
      "all_environments": true,
      "environments": []
    },
    "preferences": {
      "notifications": {
        "api_keys": false
      }
    },
    "invitation": {
      "sender": {
        "id": "5ccc2a2226393d1231eb4abd",
        "type": "account"
      },
      "recipient": "demouser@cycleplatform.io",
      "events": {
        "accepted": "2021-04-06T18:32:27.02Z",
        "declined": "0001-01-01T00:00:00Z",
        "revoked": "0001-01-01T00:00:00Z"
      }
    }
  }
}