Update a space membership | Documentation

curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/space_memberships/0xWanD4AZI2AR35wW9q51n \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "admin": false,
  "roles": [
    {
      "sys": {
        "type": "Link",
        "linkType": "Role",
        "id": "1ElgCn1mi1UHSBLTP2v4TD"
      }
    }
  ]
}'

{
  "sys": {
    "type": "SpaceMembership",
    "id": "0xWanD4AZI2AR35wW9q51n",
    "version": 0,
    "createdAt": "2026-02-26T03:15:04.000Z",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "updatedAt": "2026-02-26T03:15:04.000Z",
    "updatedBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "4FLrUHftHW3v2BLi9fzfjU"
      }
    }
  },
  "admin": false,
  "roles": [
    {
      "sys": {
        "type": "Link",
        "linkType": "Role",
        "id": "1ElgCn1mi1UHSBLTP2v4TD"
      }
    }
  ],
  "user": {
    "sys": {
      "type": "Link",
      "linkType": "User",
      "id": "7BslKh9TdKGOK41VmLDjFZ"
    }
  }
}

This endpoint allows you to change a space membership. Use this to assign additional roles or flag a user as 'admin'.

Authentication

AuthorizationBearer

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

Path parameters

space_idstringRequired

ID of the space in a form of a string

space_membership_idstringRequired

ID of the space membership in a form of a string

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful