Update a space membership | Documentation

curl -X PUT https://api.contentful.com/spaces/jn066pnp3hgr/space_memberships/jn066pnp3hgr-7uqvFPPLzgtVaezGvjA9U6 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "admin": false,
  "roles": [
    {
      "sys": {
        "type": "Link",
        "linkType": "Role",
        "id": "1ElgCn1mi1UHSBLTP2v4TD"
      }
    }
  ],
  "email": "user@example.com"
}'

{
  "admin": false,
  "sys": {
    "type": "SpaceMembership",
    "id": "jn066pnp3hgr-7uqvFPPLzgtVaezGvjA9U6",
    "version": 0,
    "createdAt": "2025-11-23T13:41:15Z",
    "updatedAt": "2025-11-23T13:41:15Z",
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "jn066pnp3hgr"
      }
    },
    "user": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7uqvFPPLzgtVaezGvjA9U6"
      }
    }
  },
  "roles": [
    {
      "sys": {
        "type": "Link",
        "linkType": "Role",
        "id": "1ElgCn1mi1UHSBLTP2v4TD"
      }
    }
  ]
}

Updates a space membership to change the user's roles or admin status. Only org admins, owners, and space admins can update memberships.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

space_idstringRequired

The space ID

space_membership_idstringRequired

The space membership ID

Request

This endpoint expects a map from strings to any.

Response

OK - Updated space membership