---
title: "Update a membership"
method: PUT
path: "/membership/{id}/"
tags: ["memberships"]
---

# Update a membership

`PUT /membership/{id}/`

## Path parameters

- `id` string, required

## Request body

- Membership — Editable settings for an organization membership.
  - `auto_record_calls` 'enabled' | 'disabled' | 'unset'
  - `default_caller_id` string, nullable — ID of the phone number to use as this member's default outbound caller ID.
  - `hangup_recording_url` string, nullable — URL of the audio file used as this member's voicemail drop recording.
  - `may_workflows_impersonate` boolean — Whether Workflows may send emails on this member's behalf.
  - `role_id` string — One of `admin`, `superuser`, `user`, or `restricteduser` for the corresponding predefined role, or the ID of a custom [Role](https://developer.close.com/api/resources/roles).
  - `track_email_opens` boolean — Whether email opens are tracked for emails this member sends.

## Response `200`

Successful response

- MembershipResponse — An organization membership.
  - `auto_record_calls` 'enabled' | 'disabled' | 'unset', required
  - `default_caller_id` string, nullable, required
  - `hangup_recording_url` string, nullable, required
  - `id` string, required
  - `may_workflows_impersonate` boolean, required
  - `onboarding_status` string, nullable, required
  - `organization_id` string, required
  - `permissions_granted` Permission[]
  - `primary_personal_number` string, nullable, required
  - `role` string
  - `role_id` string, required
  - `track_email_opens` boolean, required
  - `user` MembershipUser — A user nested in a membership response.
    - `email` string, required
    - `first_name` string, nullable, required
    - `full_name` string, nullable, required
    - `google_profile_image_url` string, nullable, required
    - `id` string, required
    - `image` string, nullable, required
    - `last_name` string, nullable, required
    - `totp_auth_state` 'enabled' | 'disabled' | 'blocked', required
  - `user_email` string
  - `user_first_name` string, nullable
  - `user_full_name` string, nullable
  - `user_google_profile_image_url` string, nullable
  - `user_id` string, required
  - `user_image` string, nullable
  - `user_last_name` string, nullable
  - `user_phone` string, nullable — Phone number in E.164 format.
  - `user_phone_formatted` string, nullable
  - `user_totp_auth_state` 'enabled' | 'disabled' | 'blocked'

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.dev/close/apis/close-api.md) · [All operations](https://skmtc.dev/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/close/close-api/revisions/59969f4fe8c1/schema)